Sideloading add-ons

Vous souhaiterez peut-être envoyer un fichier XPI à votre utilisateur par un moyen autre qu'un téléchargement sur le Web, par exemple une distribution par e-mail d'une version bêta pour les tests utilisateur. Dans ce cas, il existe deux options pratiques pour installer le module complémentaire :

  • À l'aide de l'option Installer le module à partir d'un fichier dans le gestionnaire de modules complémentaires.
  • Ajout du fichier à l'un des dossiers d'extension standard.
Aucune mise à jour automatique ne sera effectuée pour les modules complémentaires installés à l'aide de ces méthodes. Vous devrez fournir un nouveau fichier XPI à votre utilisateur pour chaque mise à jour. Cependant, des vérifications de compatibilité automatiques sont toujours effectuées.

Preparation de votre extension

Indépendamment de la méthode de chargement latéral utilisée, vous devez préparer l'extension comme suit :

  1. Assurez-vous que le module complémentaire inclut un ID, en ajoutant ce qui suit à son fichier manifest.json, en remplaçant votre your-add-on-name@your-domain.com par un ID  approprié dans vote mode complémentaire :
    "applications": {
      "gecko": {
        "id": "your-add-on-name@your-domain.com"
      }
    }
    
    Un identifiant de style d'adresse e-mail est recommandé.
  2. Signez le module complémentaire dans addons.mozilla.org (AMO).  Selon la manière dont vous souhaitez rendre votre module complémentaire disponible, vous pouvez utiliser les options non répertoriées (si vous distribuez le module complémentaire uniquement) ou répertoriées. Pour plus de détails, voir Signature et distribution de votre module complémentaire.

Utilisation de l'option Installer le module à partir d'un fichier

Pour utiliser Installer le module complémentaire à partir d'un fichier dans le gestionnaire de modules complémentaire, send the user the signed add-on with the following instructions:

  1. Enregistrez le fichier complémentaire à un emplacement approprié sur votre ordinateur.
  2. Dans Firefox, ouvrir le menu Firefox Firefox browser menu button et cliquez sur Add-ons.
  3. Dans les paramètres de cog, ouvrez Installer le module complémentaire à partir du fichier :
    Add-on Manager utilities cog
  4. Recherchez et ouvrez le fichier à partir de l'emplacement où il a été enregistré.
  5. Lorsque vous y êtes invité, cliquez sur Ajouter :
    Message asking user to confirm the installation of the add-on
  6. Le module complémentaire apparaîtra désormais dans la liste des modules complémentaires installés du gestionnaire de modules complémentaires et sera prêt à être utilisé :
    After installation the add-on is listed in the add-on manager

Installation à l'aide des dossiers d'extension standard

Cette méthode d'installation complémentaire consiste à copier le module complémentaire dans l'un des dossiers d'extension standard sur l'ordinateur de l'utilisateur. Une fois copié, la prochaine fois que Firefox sera lancé le module complémentaire sera installé. Par défaut, l'utilisateur sera invité à approuver l'installation et, si l'utilisateur l'approuve, le module complémentaire sera installé et chargé automatiquement pour les lancements ultérieurs. Si l'utilisateur possède plusieurs profils Firefox, l'approbation et l'installation auront lieu au prochain lancement de chaque profil.  Pour plus d'informations sur le contrôle de l'utilisateur à approuver l'installation, voir  Contrôle de l'installation automatique.

Renommez votre fichier XPI

Pour utiliser cette méthode, votre fichier XPI doit être nommé à l'aide de l'ID d'extension ou d'application, comme indiqué dans la section Préparation de votre module complémentaire. Le fichier complémentaire signé que vous avez téléchargé à partir d'AMO s'appellera quelque chose comme borderify-1.0-an+fx.xpi (voir Signature et distribution de votre module complémetaire pour plus de détails), modifiez-le par exemple borderify@example.com.xpi.

Si vous développez un module complémentaire pour Firefox vous pouvez utiliser un fichier proxy d'extensions pour installer un module complémentaire sans copier les fichiers dans les dossiers d'extension standard.

Ajoutez le fichier d'extension XPI dans un dossier d'extensions commun.

Dans ce qui suit {ec8030f7-c20a-464f-9b0e-13a3a9e97384} est l'identifiant de l'application de Firefox.  

L'installation standard de Firefox désactive l'installation automatique de modules complémentaires à partir de ces emplacements (voir Contrôle de l'installation automatique). Par conséquent, le processus pour chacune des méthodes décrites ci-dessous est le suivant :

  • Copiez le fichier XPI renommé dans le dossier des extensions pour WindowsOSX, ou Linux selon le cas. Notez que, selon le système d'exploitation de bureau et ses paramètres, l'utilisateur peut avoir besoin d'une autorisation d'administrateur pour effectuer cette action.
  • Fermez et redémarrez Firefox.
  • Selon le système d'exploitation et la version de Firefox, l'un des événements suivants se produira:
    • L'installation se fera en mode silencieux et l'utilisateur devra ouvrir le gestionnaire de modules complémentaires et activer le module complémentaire :
      An add-on is installed but disabled
      Pour activer le module complémentaire, l'utilisateur devra cliquer sur  Enable.
    • Un message interstitiel sera affiché :
      An interstitial warning about the installation of the add-on
      Pour installer le module complémentaire, l'utilisateur devra cocher Autoriser cette installation et cliquer sur Continuer.
  • L'add-on est maintenant installé.

Pour plus de détails sur les installations interstitielles et silencieuses, voir Contrôle de l'installation automatique.

Pour désinstaller le module complémentaire, fermez Firefox et supprimez le module complémentaire de l'emplacement où il a été ajouté.

Windows

Pour installer le module complémentaire pour un utilisateur de l'ordinateur, copiez le fichier XPI dans :

C:\Users\<user name>\AppData\Roaming\Mozilla\Extensions\{ec8030f7-c20a-464f-9b0e-13a3a9e97384}\

Si ce dossier n'existe pas, créez-le. Vous pouvez également identifier le chemin de l'utilisateur actuel avec la variable %appdata% du système.

Remarque : Pour installer un module complémentaire pour tous les utilisateurs d'un ordinateur Windows, voir Installation à l'aide du registre Windows.

OSX

Pour installer un module complémentaire à utiliser par tous les profils Firefox et tous les utilisateurs, copiez le fichier XPI dans le dossier d'extension globale situé dans la bibliothèque. Si ce dossier n'existe pas, vous devrez le créer.

/Library/Application Support/Mozilla/Extensions/{ec8030f7-c20a-464f-9b0e-13a3a9e97384}/

Pour installer un module complémentaire pour un utilisateur spécifique, copiez le fichier XPI dans la bibliothèque locale de l'utilisateur :

~/Library/Application Support/Mozilla/Extensions/{ec8030f7-c20a-464f-9b0e-13a3a9e97384}/

Linux

Pour installer un module complémentaire utilisé par tous les utilisateurs, copiez le fichier XPI dans :

/usr/lib/Mozilla/extensions/{ec8030f7-c20a-464f-9b0e-13a3a9e97384}/

Ou...

/usr/lib64/Mozilla/extensions/{ec8030f7-c20a-464f-9b0e-13a3a9e97384}/

Ou...

/usr/share/mozilla/extensions/{ec8030f7-c20a-464f-9b0e-13a3a9e97384}/

Pour installer un module complémentaire pour un utilisateur spécifique, copiez le fichier XPI dans :

~/.Mozilla/extensions/{ec8030f7-c20a-464f-9b0e-13a3a9e97384}/

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,