Empaqueter une extension

  • Raccourci de la révision : Empaqueter_une_extension
  • Titre de la révision : Empaqueter une extension
  • ID de la révision : 331785
  • Créé :
  • Créateur : Jeremie
  • Version actuelle ? Non
  • Commentaire

Contenu de la révision

 

Les extensions sont une forme de paquets installables qui peuvent être téléchargés et installés par un utilisateur ou fournis préempaquetées avec une application ou un programme externe. Les extensions utilisent une structure de répertoire pouvant fournir du chrome, des composants et d'autres fichiers permettant d'étendre les fonctionnalités d'un programme XUL.

Chaque extension doit fournir un fichier install.rdf contenant des métadonnées à propos de l'extension, comme son ID unique, sa version, son auteur et des informations de compatibilité.

Lorsque les fichiers de l'extension et install.rdf sont prêts, il y a plusieurs manières de de préparer une extension pour son installation : zipper le répertoire de l'extension dans un XPI installable par l'utilisateur (xpinstall), décompresser l'extension directement dans le répertoire de l'application ou du profil de l'utilisateur, ou enregistrer l'extension via la base de registres de Windows.

Réalisation d'un XPI d'extension

Un fichier XPI (XPInstall) est simplement un fichier ZIP contenant les fichiers de l'extension, avec le fichier install.rdf à la racine du ZIP. Les utilisateurs peuvent télécharger et installer des fichiers XPI depuis un site Web ou depuis un fichier local, en l'ouvrant ou en le glissant vers la fenêtre du gestionnaire d'extensions.

Le type MIME reconnu par Firefox pour les fichiers XPI est application/x-xpinstall. Comme la plupart des serveurs HTTP ne sont pas configurés pour renvoyer ce type MIME pour les fichiers d'extension .xpi par défaut, il sera sans doute nécessaire de reconfigurer votre serveur. Pour les serveurs HTTP Apache, cela peut se faire en ajoutant la directive suivante au fichier de configuration httpd.conf ou à un fichier .htaccess :

AddType application/x-xpinstall .xpi

Installation directe de fichiers d'extension

Si vous connaissez l'emplacement de l'application (si vous installez une extension au cours du programme d'installation de l'application par exemple), vous pouvez installer les fichiers de l'extension directement dans <appdir>/extensions/<extensionID>. L'extension sera trouvée automatiquement par le gestionnaire d'extensions au prochain lancement de l'application.

Lorsque vous utilisez cette méthode, vous devez vérifier que les permissions du système de fichiers pour les répertoires et fichiers de l'extension sont positionnées correctement. Dans le cas contraire, le gestionnaire d'extensions peut ne pas fonctionner correctement avec l'extension, ou l'extension elle-même peut ne pas fonctionner comme il faut.

Enregistrement d'une extension à l'aide de la base de registres de Windows

Les programmes d'installation externes (comme l'environnement d'exécution Java) peuvent vouloir installer des points d'intégration vers leur application en tant qu'extension même si l'application n'est pas encore installée. Ceci peut être réalisé sous Windows en utilisant la base de registres.

XPI d'extension contenant plusieurs éléments

Dans certains cas, un seul fichier XPI peut vouloir installer plusieurs extensions/thèmes. Un genre spécial d'XPI d'extension appelé Paquetage multi extensions explique comment créer ce type de paquet. (Firefox 1.5/XULRunner 1.8 est nécessaire.)

Références officielles de l'API du toolkit

{{ :fr/API_du_toolkit/Références_officielles() }}

Source de la révision

<p>&nbsp;</p>
<p>Les extensions sont une forme de <a href="fr/Bundles">paquets installables</a> qui peuvent être téléchargés et installés par un utilisateur ou fournis préempaquetées avec une application ou un programme externe. Les extensions utilisent une <a href="fr/Bundles">structure de répertoire</a> pouvant fournir du chrome, des composants et d'autres fichiers permettant d'étendre les fonctionnalités d'un programme XUL.</p>
<p>Chaque extension doit fournir un fichier <a href="fr/Install.rdf">install.rdf</a> contenant des métadonnées à propos de l'extension, comme son ID unique, sa version, son auteur et des informations de compatibilité.</p>
<p>Lorsque les fichiers de l'extension et <code>install.rdf</code> sont prêts, il y a plusieurs manières de de préparer une extension pour son installation&nbsp;: zipper le répertoire de l'extension dans un <a href="fr/XPI">XPI</a> installable par l'utilisateur (xpinstall), décompresser l'extension directement dans le répertoire de l'application ou du profil de l'utilisateur, ou enregistrer l'extension via la base de registres de Windows.</p>
<h3 id="R.C3.A9alisation_d.27un_XPI_d.27extension" name="R.C3.A9alisation_d.27un_XPI_d.27extension">Réalisation d'un XPI d'extension</h3>
<p>Un fichier <a href="fr/XPI">XPI</a> (XPInstall) est simplement un fichier ZIP contenant les fichiers de l'extension, avec le fichier <code><a href="fr/Install.rdf">install.rdf</a></code> à la racine du ZIP. Les utilisateurs peuvent télécharger et installer des fichiers XPI depuis un site Web ou depuis un fichier local, en l'ouvrant ou en le glissant vers la fenêtre du gestionnaire d'extensions.</p>
<p>Le type MIME reconnu par Firefox pour les fichiers XPI est <i><code>application/x-xpinstall</code></i>. Comme la plupart des serveurs HTTP ne sont pas configurés pour renvoyer ce type MIME pour les fichiers d'extension <code>.xpi</code> par défaut, il sera sans doute nécessaire de reconfigurer votre serveur. Pour les serveurs HTTP Apache, cela peut se faire en ajoutant la directive suivante au fichier de configuration <code>httpd.conf</code> ou à un fichier <code>.htaccess</code>&nbsp;:</p>
<pre class="eval">
AddType application/x-xpinstall .xpi
</pre>
<h3 id="Installation_directe_de_fichiers_d.27extension" name="Installation_directe_de_fichiers_d.27extension">Installation directe de fichiers d'extension</h3>
<p>Si vous connaissez l'emplacement de l'application (si vous installez une extension au cours du programme d'installation de l'application par exemple), vous pouvez installer les fichiers de l'extension directement dans <code>&lt;appdir&gt;/extensions/&lt;extensionID&gt;</code>. L'extension sera trouvée automatiquement par le gestionnaire d'extensions au prochain lancement de l'application.</p>
<p>Lorsque vous utilisez cette méthode, vous devez vérifier que les permissions du système de fichiers pour les répertoires et fichiers de l'extension sont positionnées correctement. Dans le cas contraire, le gestionnaire d'extensions peut ne pas fonctionner correctement avec l'extension, ou l'extension elle-même peut ne pas fonctionner comme il faut.</p>
<h3 id="Enregistrement_d.27une_extension_.C3.A0_l.27aide_de_la_base_de_registres_de_Windows" name="Enregistrement_d.27une_extension_.C3.A0_l.27aide_de_la_base_de_registres_de_Windows">Enregistrement d'une extension à l'aide de la base de registres de Windows</h3>
<p>Les programmes d'installation externes (comme l'environnement d'exécution Java) peuvent vouloir installer des points d'intégration vers leur application en tant qu'extension même si l'application n'est pas encore installée. Ceci peut être réalisé sous Windows en <a href="fr/Ajout_d'extensions_%c3%a0_l'aide_de_la_base_de_registres_de_Windows">utilisant la base de registres</a>.</p>
<h3 id="XPI_d.27extension_contenant_plusieurs_.C3.A9l.C3.A9ments" name="XPI_d.27extension_contenant_plusieurs_.C3.A9l.C3.A9ments">XPI d'extension contenant plusieurs éléments</h3>
<p>Dans certains cas, un seul fichier XPI peut vouloir installer plusieurs extensions/thèmes. Un genre spécial d'XPI d'extension appelé <a href="fr/Paquetage_multi_extensions">Paquetage multi extensions</a> explique comment créer ce type de paquet. (Firefox 1.5/XULRunner 1.8 est nécessaire.)</p>
<h3 id="R.C3.A9f.C3.A9rences_officielles_de_l.27API_du_toolkit" name="R.C3.A9f.C3.A9rences_officielles_de_l.27API_du_toolkit">Références officielles de l'<a href="fr/API_du_toolkit">API du toolkit</a></h3>
<p>{{ :fr/API_du_toolkit/Références_officielles() }}</p>
Revenir à cette révision