files/fr/archive/mozilla/xulrunner/empaqueter_une_application_xul/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

---
title: Empaqueter une application XUL
slug: Archive/Mozilla/XULRunner/Empaqueter_une_application_XUL
tags:
  - XUL
  - XULRunner
translation_of: Archive/Mozilla/XULRunner/XUL_Application_Packaging
---
<p>Les paquets d'application <a href="/fr/XULRunner" title="fr/XULRunner">XULRunner</a> sont des paquets standard du toolkit (comme les extensions Firefox), avec un fichier manifest en plus (<code>application.ini</code>) 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 <a href="/fr/Notes_de_versions_de_XULRunner_1.8.0.4" title="fr/Notes_de_versions_de_XULRunner_1.8.0.4">Notes de versions de XULRunner 1.8.0.4</a> <small>(à traduire de <a href="/en/XULRunner_1.8.0.4_Release_Notes">en:XULRunner_1.8.0.4_Release_Notes</a>)</small>).</p>

<h3 id="application.ini" name="application.ini">application.ini</h3>

<p>Le fichier manifest <code>application.ini</code> 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 <code>'Headings'</code> et <code>Key=Value</code>. Les lignes commençant par <code>;</code> ou <code>#</code> sont traités comme des commentaires.</p>

<p>Vous pouvez trouver un exemple de <code>application.ini</code> dans <a href="https://dxr.mozilla.org/mozilla-central/source/xulrunner/examples/simple/application.ini" rel="custom">le code source de Mozilla</a>.</p>

<h2 id="Section_.5BApp.5D" name="Section_.5BApp.5D">Section [App]</h2>

<p>La partie <code>App</code> spécifie les metadonnées sur l'application</p>

<dl>
 <dt>Name</dt>
 <dd>Indique le nom de l'application.<br>
 REQUIS<br>
 Exemple : <code>Name=TestApplication</code></dd>
 <dt>Version</dt>
 <dd>Indique la version de l'application<br>
 REQUIS<br>
 Voir <a href="/fr/Format_de_version_du_toolkit" title="fr/Format_de_version_du_toolkit">Format de version du toolkit</a> pour les détails sur le numérotage des versions<br>
 Exemple : <code>Version=0.1</code></dd>
 <dt>BuildID</dt>
 <dd>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.<br>
 REQUIS<br>
 Exemple : <code>BuildID=20060201</code></dd>
 <dt>ID</dt>
 <dd>Spécifie un l'identifiant unique de l'application<br>
 REQUIS<br>
 L'ID de l'application, comme les IDs d'extensions, peuvent être formés soit comme un email <code><a class="link-mailto" href="mailto:ApplicationName@vendor.tld" rel="freelink">ApplicationName@vendor.tld</a></code> ou comme un UUID (Universal Unique Identifier) <code>{12345678-1234-1234-1234-123456789abc}</code>. Le format email est préférable pour les nouveaux développements d'application.<br>
 Exemple: <code><a class="link-mailto" href="mailto:ID=TestApplication@example.tld" rel="freelink">ID=TestApplication@example.tld</a></code></dd>
 <dt>Vendor</dt>
 <dd>Indique le vendeur de l'application<br>
 OPTIONNEL<br>
 Exemple : <code>Vendor=Grinch Productions</code></dd>
</dl>

<h2 id="Section_.5BGecko.5D" name="Section_.5BGecko.5D">Section [Gecko]</h2>

<p>La partie <code>Gecko</code> spécifie quelle version de XULRunner est requise par l'application.</p>

<dl>
 <dt>MinVersion</dt>
 <dd>Indique la version minimale de XULRunner requise pour l'application.<br>
 REQUIS<br>
 Exemple : <code>MinVersion=1.8</code></dd>
 <dt>MaxVersion</dt>
 <dd>Indique la version maximum de XULRunner dont l'application à besoin.<br>
 OPTIONNEL - la valeur par défaut correspond à n'importe quelle version de XULRunner inférieure à XULRunner 2<br>
 Exemple : <code>MaxVersion=1.8.0.*</code></dd>
</dl>

<h2 id="Section_.5BXRE.5D" name="Section_.5BXRE.5D">Section [XRE]</h2>

<p>La section <code>XRE</code> spécifie diverses caractéristiques possibles du démarrage de XULRunner.</p>

<dl>
 <dt id="em">EnableExtensionManager</dt>
 <dd>Spécifie si les extensions sont activées. Il peut prendre la valeur 1 ou 0.<br>
 OPTIONNEL - La valeur par défaut est 0<br>
 Exemple : <code>EnableExtensionManager=1</code></dd>
 <dt>EnableProfileMigrator&lt;/dt&gt;</dt>
 <dd>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.<br>
 OPTIONNEL - La valeur par défaut est 0<br>
 Exemple : <code>EnableProfileMigrator=1</code></dd>
</dl>