Xul Runner/Application

Développement d’une application XulRunner

Voici un petit tutoriel pour développer une application utilisant XulRunner.

Pour le suivre, il vous faut installer XulRunner. Voir les instructions sur XulRunner/Installation.

Structure d’une application

Une application XulRunner a son propre répertoire, installé où vous le souhaitez sur votre disque. Ce répertoire doit contenir l’arborescence suivante :

• application.ini
• chrome.manifest
• install.rdf
• chrome/
  • content/
  • locale/
  • skin/
  • icons/
• components/
  • ...
• defaults/
  • preferences/

Comme vous le reconnaissez, il s’agit d'une structure similaire à celle fournie dans un fichier XPI pour Gecko 1.8. La différence principale est ce nouveau fichier « application.ini ».

Indiquer comment l’application doit se lancer

Pour des applications simples, il suffit d’indiquer le fichier XUL à exécuter lors du lancement, en indiquant dans un fichier Javascript stocké dans « defaults/preferences/ », la ligne :

 pref("toolkit.defaultChromeURI", "chrome://mycoolapp/content/start.xul");

Pour les applications plus complexes, vous voulez peut être avoir la possibilité de saisir des paramètres spécifiques dans la ligne de commande de XulRunner. Dans ce cas, il faut faire un objet qui permettra la récupération de ces paramètres. Voir un exemple dans ce fichier : http://lxr.mozilla.org/mozilla/source/toolkit/components/nsDefaultCLH.js

Le fichier « application.ini »

Son contenu a la même syntaxe que les fichiers « .ini » classiques. Vous avez deux sections, « App » et « Gecko ».

 [App]
 ; Nom de l'auteur, de l'éditeur, etc.
 Vendor=Prénom Nom

 ; Nom de votre application.
 Name=?NomApplication

 ; Version de votre application.
 Version=1.0

 ; Un numéro de version interne, modifié à chaque modification de votre
 ; application. Il contient en général un « timestamp ».
 BuildID=20070518

 ; Le copyright.
 Copyright=Copyright © 2007 Prénom Nom (aka Pseudo)

 ; Identifiant unique de votre application au format courriel ou UUID exemple :
 ID=NomApplication@vendor

 [Gecko]
 MinVersion=1.8
 MaxVersion=1.9a1

 [shell]
 Icon=chrome/icons/

 [XRE]
 ; active le gestionnaire d'extension
 EnableExtensionManager=true

Les autres fichiers

En ce qui concerne le répertoire « chrome », « components », « install.rdf », etc., reportez-vous à la section Extensions. En particulier pour ce qui concerne l’enregistrement « chrome ».

Déploiement de l’application

Vous avez réalisé votre application. Il est temps maintenant de la déployer, de la livrer dans une forme facilement installable par l’utilisateur. Ce que vous allez livrer et comment dépend de votre plateforme. Voir la page « Deploying_XULRunner_1.8 » pour les explications.

Autres ressources

• Un mini-tutoriel : http://brian.kingsonline.net/talk/index.php/archives/115
• Un autre assez complet: http://www.supinfo-projects.com/fr/2006/application_xulrunner/

• Sommaire XulRunner
  • Installer XulRunner
  • ?Installer et lancer une appli XulRunner
  • Arguments en ligne de commande de XulRunner
  • Développer une application XulRunner