Mozilla wants to hear from developers like you. http://www.surveygizmo.com/s3/2737536/440b74c45e94?a=mdn

Ajouter des extensions en utilisant le Registre Windows

Cet article nécessite une relecture technique. Voici comment vous pouvez aider.

Introduction

Ce document explique comment installer des extensions pour Firefox et Thunderbird en passant par le Registre Windows. Ce méchanisme est pensé pour faciliter l'enregistrement d'extensions par des installeurs tiers.

Installation

L'installation s'effectue en écrivant une entrée dans le Registre Windows, il y a deux possibillités :

HKEY_CURRENT_USER\Software\Vendeur\Nom\Extensions
HKEY_LOCAL_MACHINE\Software\Vendeur\Nom\Extensions

Vendeur et Nom sont les valeurs retournées par les propriétés de nsIXULAppInfo. Dans les produits de Mozilla, Vendeur et "Mozilla" et Nom est le nom du produit (Firefox, Thunderbird), ex :

HKEY_CURRENT_USER\Software\Mozilla\Firefox\Extensions
HKEY_CURRENT_USER\Software\Mozilla\Thunderbird\Extensions

Ou sous Windows 7/x64 :

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mozilla\Firefox\Extensions
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mozilla\Thunderbird\Extensions

L'ID de l'extension doit être utilisée comme nom de l'entrée de Registre. L'entrée de Registre doit être du type REG_SZ et sa valeur doit être le chemin absolu du dossier contenant l'extension (la location du XPI décompressé). Par exemple, pour installer l'extension décrite dans l'article de Création d'une Extension il faut créer l'entrée de registre ayant pour nom sample@foo.net et pour valeur c:\extensions\monExtension.

Après avoir créé l'entrée de registre, Firefox ou Thunderbird se rendra compte du changement au prochain lancement. La modification des entrées de Registre alors que Thunderbird ou Firefox est lancé ne comporte pas de risque.

Si les mêmes extensions apparaîssent dans HKEY_CURRENT_USER et HKEY_LOCAL_MACHINE ce sera l'extension contenue dans HKEY_CURRENT_USER qui sera utilisée. Si l'extension apparaît également dans le dossier du profil de l'utilisateur (après une installation manuelle), elle prendra le dessus de n'importe quelle instance trouvée dans le Registre.

Désinstallation

Les extensions installées avec le Registre  Windows peuvent être simplement désinstallées en supprimant l'entrée de Registre y correspondant. Après la suppression, Firefox ou Thunderbird se rendrons compte du changement au prochain lancement. La suppression des clés de Registre alors que Thunderbird ou Firefox est lancé ne comporte pas de risque.

Mise à jour

Firefox ne se rend pas automatiquement compte des changements de install.rdf car il vérifie la date de modification du répertoire de l'extension avant de vérifier install.rdf. Il est possible de contourner le problème en supprimant et recréant le répertoire ou en modifiant la date de modification.

Plugins

Avec Windows 7 et Firefox 9.0 (d'autres cas possibles) le fonctionnement des plugins et quelque peu différent.

L'installation se fait en créant une des deux entrées suivantes :

HKEY_CURRENT_USER\Software\MozillaPlugins\plugin-id
HKEY_LOCAL_MACHINE\Software\MozillaPlugins\plugin-id

Sur un Windows 64 bits :

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\MozillaPlugins\plugin-id

plugin-id correspond à l'id de l'extension (contenue dans install.rdf), en suivant l'exemple précédant : sample@foo.net

Note : Il semblerais que les plugins soient chargés depuis tous les types de clé de registre.

La clé de Registre doit avoir comme valeur nommée Path de type REG_SZ contenant un chemin absolu vers le DLL du plugin. La clé peut avoir des valeurs supplémentaires, comme Description, ProductName, Vendor et GeckoVersion.

Voir aussi

Étiquettes et contributeurs liés au document

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