Les paquets d'application XULRunner sont des paquets standard du toolkit (comme les extensions Firefox), avec un fichier manifest en plus (application.ini) qui décrit l'application. Les paquets d'application sont généralement compressées au format zip dans une archive avec l'extension .xulapp ou .xpi. Ils peuvent être installés avec la ligne de commande XULRunner "-install-app" (voir les Notes de versions de XULRunner 1.8.0.4 (à traduire de en:XULRunner_1.8.0.4_Release_Notes)).
application.ini
Le fichier manifest application.ini se trouve à la racine de le l'extension et fournit les metadonnées pour permettre au XULRunner de lancer correctement l'application. Il est analysé comme un fichier style INI windows avec le couple 'Headings' et Key=Value. Les lignes commençant par ; ou # sont traités comme des commentaires.
Vous pouvez trouver un exemple de application.ini dans le code source de Mozilla.
Section [App]
La partie App spécifie les metadonnées sur l'application
- Name
- Indique le nom de l'application.
REQUIS
Exemple :Name=TestApplication - Version
- Indique la version de l'application
REQUIS
Voir Format de version du toolkit pour les détails sur le numérotage des versions
Exemple :Version=0.1 - BuildID
- Indique un identifiant de compilation unique. Il s'agit généralement d'un identifiant temporel, devrait être différent pour chaque version publiée de l'application.
REQUIS
Exemple :BuildID=20060201 - ID
- Spécifie un l'identifiant unique de l'application
REQUIS
L'ID de l'application, comme les IDs d'extensions, peuvent être formés soit comme un email[email protected]ou comme un UUID (Universal Unique Identifier){12345678-1234-1234-1234-123456789abc}. Le format email est préférable pour les nouveaux développements d'application.
Exemple:[email protected] - Vendor
- Indique le vendeur de l'application
OPTIONNEL
Exemple :Vendor=Grinch Productions
Section [Gecko]
La partie Gecko spécifie quelle version de XULRunner est requise par l'application.
- MinVersion
- Indique la version minimale de XULRunner requise pour l'application.
REQUIS
Exemple :MinVersion=1.8 - MaxVersion
- Indique la version maximum de XULRunner dont l'application à besoin.
OPTIONNEL - la valeur par défaut correspond à n'importe quelle version de XULRunner inférieure à XULRunner 2
Exemple :MaxVersion=1.8.0.*
Section [XRE]
La section XRE spécifie diverses caractéristiques possibles du démarrage de XULRunner.
- EnableExtensionManager
- Spécifie si les extensions sont activées. Il peut prendre la valeur 1 ou 0.
OPTIONNEL - La valeur par défaut est 0
Exemple :EnableExtensionManager=1 - EnableProfileMigrator</dt>
- Spécifie si, quand l'application est lancée pour la première fois et qu'il n'y a pas de profils, le code de migration de profil doit être activé par l'interface nsIProfileMigrator. Les valeurs possibles sont 1 et 0.
OPTIONNEL - La valeur par défaut est 0
Exemple :EnableProfileMigrator=1