Une fois que vous avez terminé d'écrire et de tester votre extension, vous voudrez probablement la partager avec d'autres personnes. Mozilla propose un site web : addons.mozilla.org (communément abrégé en AMO), où les développeurs peuvent publier des extensions et les utilisateurs peuvent les trouver. En publiant votre extension sur AMO, vous pouvez participer à notre communauté d'utilisateurs et de créateurs, et trouver un public pour votre extension.
Vous n'avez pas à publier votre extension sur AMO. Cependant, même si vous n'avez pas l'intention de publier votre extension sur AMO, vous devez la soumettre à AMO afin qu'elle puisse être examinée et signée. Les versions finales de Firefox refuseront d'installer des extensions qui ne sont pas signés par AMO.
Ainsi, le processus de publication d'une extension se résume :
- Compresser les fichiers de votre extension en un fichier zip
- Créer un compte sur AMO
- Télécharger votre zip sur AMO pour la signature et l'examen, et choisir de la publier dans AMO ou non
- Résoudre les problèmes rencontrés lors de la relecture
- Si vous avez choisi de ne pas publier sur AMO, récupérez le complément signé et publiez-le vous-même
Lorsque vous êtes prêt à publier une nouvelle version de votre extension, vous pouvez la mettre à jour en visitant la page des extensions sur addons.mozilla.org, et en téléchargeant la nouvelle version. Notez que vous devez la mettre à jour sur la page de l'extension, de sorte AMO reconnaît qu'il s'agit d'une mise à jour d'une extension existante, et pas une nouvelle.
Si vous choisissez de publier votre extension sur AMO, Firefox vérifiera automatiquement les mises à jour. Si vous avez choisi de le publier vous-même, vous devrez inclure la clé de l'applications dans votre manifeste.json, avec l'attribut update_url défini pour pointer vers un fichier manifest de mise à jour.
Les extensions packagées dans Firefox sont appelées « fichiers XPI », qui sont simplement des fichiers ZIP avec une extension différente.
Vous n'avez pas à utiliser l'extension XPI lors du chargement vers AMO.
1. Zipper vos fichiers d'extensions
A ce stade, votre extension se composera d'un répertoire contenant un manifeste.json et tous les autres fichiers dont il a besoin – des scripts, des icônes, des documents HTML, et ainsi de suite. Vous devrez les zipper dans un seul fichier pour les transférer vers AMO.
Une astuce est que le fichier ZIP doit être un ZIP des fichiers de l'extension eux-mêmes, et non du répertoire racine.
Windows
- Ouvrez le dossier avec vos fichiers de l'extension.
- Sélectionnez tous les fichiers.
- Cliquez sur le bouton droit de la souris et choisissez Envoyer vers → Dossier compressé (zippé).
Mac OS X
- Ouvrez le dossier avec vos fichiers de l'extension.
- Sélectionnez tous les fichiers.
- Cliquez sur le bouton droit de la souris et choisissez Compress n Items.
Linux / Mac OS X Terminal
cd path/to/my-addon/zip -r ../my-addon.zip *
2. Créer un compte sur addons.mozilla.org
Visitez https://addons.mozilla.org/. Si vous avez un compte Firefox, vous pouvez l'utiliser pour vous connecter. Sinon, cliquez sur « S'enregistrer » et vous serez invité à créer un compte Firefox.
3. Télécharger votre zip
Ensuite, téléchargez l'extension compressée à AMO pour la signature et l'examen, et choisissez de la publier dans AMO ou non. Un tutorial est disponible pour vous guider dans le processus de soumission. Pour plus de détails, voir Soumettre à AMO.
Notez qu'une fois que vous avez téléchargé votre extension vers AMO, vous ne pouvez pas mettre à jour l'extension pour utiliser le SDK d'extension ou les techniques XUL / XPCOM héritées. Si vous passez à l'une de ces plates-formes, vous devez la soumettre comme une extension complètement nouvelle.
C'est-à-dire : le portage d'anciens systèmes d'extension vers WebExtensions est une voie à sens unique.
Avant de télécharger, vérifiez que le ZIP contient exactement le contenu que vous souhaitez soumettre, sans aucun fichier redondant supplémentaire.
4. Résoudre les problèmes d'examen
Dès que vous téléchargez l'extension, le serveur AMO effectuera quelques vérifications de base et vous informera immédiatement de tout problème. Les problèmes sont présentés en deux catégories: «erreurs» et «avertissements». Si vous avez des erreurs, vous devez les corriger et les renvoyer. Si vous avez seulement des avertissements, il est conseillé de les adresser, mais ce n'est pas obligatoire: vous pouvez continuer la soumission.
Si le vérificateur ne signale aucune erreur, l'extension va subir un examen plus détaillé. Vous serez contacté (e) avec les résultats de l'examen et vous devrez résoudre les problèmes éventuels et les resoumettre à nouveau.
Si vous avez choisi que l'extension sera hébergée sur AMO, c'est la fin du processus de publication. AMO signera l'extension et la publiera, et les utilisateurs pourront ensuite le télécharger et l'installer.
5. Publier votre extension
Si vous avez choisi de ne pas publier sur AMO, récupérez l'extension signée et publiez-la vous-même.