Autres façons de distribuer les extensions

Article
12/14/2023

En règle générale, les extensions sont distribuées via le site web des modules complémentaires Microsoft Edge. Dans certains scénarios, les développeurs peuvent avoir besoin de distribuer des extensions à l’aide d’autres méthodes. Par exemple :

L’extension est associée à d’autres logiciels et doit être installée avec le reste du logiciel groupé.
Les administrateurs réseau souhaitent distribuer une extension dans leur organization.

Les extensions qui ne sont pas chargées à partir du magasin de modules complémentaires Edge sont appelées extensions installées en externe. Voici d’autres méthodes de distribution des extensions installées en externe :

Utilisez le Registre Windows (Windows uniquement).
Utilisez un fichier JSON de préférences (macOS et Linux).

Ces approches sont décrites ci-dessous.

Avant de commencer

Veillez à publier votre extension sur le site web des modules complémentaires Microsoft Edge ou à empaqueter un .crx fichier et à vérifier qu’elle s’installe correctement sur votre ordinateur. Si vous installez le fichier à l’aide .crx de update_url, vérifiez que vous pouvez accéder à votre extension à cette URL.

Vérifiez également que vous disposez des informations suivantes :

Chemin d’accès du .crx fichier ou de update_url votre extension.
Version de votre extension. Les informations de version sont disponibles dans votre fichier manifeste ou dans Microsoft Edge à l’adresse edge://extensions suivant le chargement de l’extension packed.
ID de votre extension. Les informations d’ID sont disponibles dans Microsoft Edge à l’adresse edge://extensions suivant le chargement de l’extension pack.

Les exemples suivants utilisent 1.0 comme version et aaaaaaaabbbbbbbbccccccccdddddddd pour l’ID.

Utilisation du Registre Windows (Windows uniquement)

Pour distribuer votre extension à l’aide du Registre Windows :

Recherchez ou créez la clé suivante dans le Registre :
- Windows 32 bits : HKEY_LOCAL_MACHINE\Software\Microsoft\Edge\Extensions
- Windows 64 bits : HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\Edge\Extensions
Créez une clé ou un dossier, sous Extensions portant le même nom que l’ID de votre extension. Par exemple, créez la clé avec le nom aaaaaaaabbbbbbbbccccccccdddddddd.
Dans la clé Extensions , créez la update_url propriété et définissez la valeur sur https://edge.microsoft.com/extensionwebstorebase/v1/crx. La update_url propriété pointe vers le .crx fichier de votre extension dans le site web des modules complémentaires Microsoft Edge.
```
{
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
Remarque

Si vous souhaitez installer une extension à partir du Chrome Web Store, définissez la valeur de update_url sur https://clients2.google.com/service/update2/crx.
Dans Microsoft Edge, accédez à edge://extensions, puis vérifiez que votre extension est répertoriée.

Utilisation d’un fichier JSON de préférences (macOS et Linux)

Pour distribuer votre extension à l’aide d’un fichier JSON de préférences :

Lorsque vous utilisez Linux, assurez-vous que votre .crx fichier d’extension est disponible sur l’ordinateur sur lequel l’extension sera installée. Copiez le .crx fichier d’extension dans un répertoire local ou utilisez un partage réseau accessible à partir de l’ordinateur.
Créez un fichier JSON où le nom du fichier correspond à l’ID de votre extension. Par exemple, créez un fichier JSON avec le nom aaaaaaaabbbbbbbbccccccccdddddddd.jsonde fichier .

Le nom du fichier JSON des préférences est l’ID CRX de votre extension Microsoft Edge, suivi d’une .json extension. L’ID CRX est un code unique de 32 caractères, qui correspond aux lettres présentes à la fin de l’URL de votre extension.
En fonction de votre système d’exploitation, enregistrez le fichier JSON dans l’un des dossiers suivants :
- MacOS
  - Spécifique à l’utilisateur : ~USERNAME/Library/Application Support/Microsoft Edge/External Extensions/
  - Pour tous les utilisateurs : /Library/Application Support/Microsoft/Edge/External Extensions/
  Pour empêcher les utilisateurs non autorisés d’installer des extensions pour tous les utilisateurs, assurez-vous que votre fichier de préférences d’extension est en lecture seule.
  
  Vérifiez également que les conditions suivantes sont remplies :
  - Chaque répertoire du chemin d’accès appartient à la racine de l’utilisateur.
  - Chaque répertoire du chemin d’accès est affecté au admin groupe ou .wheel
  - Chaque répertoire du chemin d’accès n’est pas world accessible en écriture.
  - Le chemin doit être exempt de liens symboliques.
- Linux
  - Spécifique à l’utilisateur : ~/.config/microsoft-edge/External Extensions/
  - Pour tous les utilisateurs : /usr/share/microsoft-edge/extensions/
Selon votre scénario, copiez le code approprié qui suit dans le fichier JSON de vos préférences.
- S’applique uniquement à Linux. Si vous installez à partir d’un fichier, spécifiez l’emplacement et la version dans external_crx et external_version:
```
{
    "external_crx": "/home/share/extension.crx",
    "external_version": "1.0"
}
```
- S’applique à macOS et Linux. Si vous installez à partir d’un update_url, spécifiez l’URL de mise à jour dans external_update_url.
  
  Copiez le code suivant dans le fichier JSON de vos préférences lors de l’installation à partir de fichiers locaux .crx sur Linux uniquement :
```
{
    "external_update_url": "http://myhost.com/mytestextension/updates.xml"
}
```
- Copiez le code suivant dans le fichier JSON de vos préférences lors de l’installation à partir du site web des modules complémentaires Microsoft Edge sur macOS et Linux :
```
{
    "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
Pour installer des extensions pour des paramètres régionaux spécifiques, répertoriez les paramètres régionaux pris en charge dans supported_locales.

Vous pouvez spécifier des paramètres régionaux parents pour installer votre extension pour tous les paramètres régionaux de langue qui utilisent ce parent. Par exemple, lorsque vous utilisez les paramètres régionaux enparents , votre extension s’installe pour tous les paramètres régionaux anglais, tels que en-US, en-GB, et ainsi de suite. Lorsque les utilisateurs modifient leurs paramètres régionaux dans leur navigateur, les extensions installées en externe sont désinstallées. Pour installer votre extension pour les paramètres régionaux, n’utilisez supported_localespas .
```
{
    "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
    "supported_locales": [ "en", "fr", "de" ]
}
```
Vérifiez que votre extension est installée dans Microsoft Edge en accédant à edge://extensions.

Mettre à jour et désinstaller les extensions installées en externe

Microsoft Edge analyse les entrées de métadonnées dans le Registre chaque fois que le navigateur démarre et apporte des modifications aux extensions installées en externe.

Pour mettre à jour votre extension vers une nouvelle version, mettez à jour la version chaîne dans le fichier manifeste d’extension, puis mettez à jour la version dans le Registre.

Vous devrez peut-être désinstaller les extensions installées en externe, qui ont été installées dans le cadre d’un ensemble de logiciels précédemment installés sur l’ordinateur. Pour désinstaller votre extension, supprimez le fichier JSON de vos préférences ou supprimez la clé du Registre.

Voir aussi :

Format de fichier manifeste pour les extensions

Blocage des extensions

Les stratégies pour ExtensionInstallForcelist, liste de blocs et ExtensionSettings sont utilisées lorsque les entreprises souhaitent installer ou bloquer des extensions spécifiques sur les ordinateurs clients. Les extensions et leur origine configurées dans ExtensionInstallForcelist, ExtensionInstallSources ou ExtensionSettings sont prioritaires sur BlockExternalExtensions.

Si la BlockExternalExtensions stratégie est définie sur Not Configured ou Disabled, cela n’a aucun effet. Si la BlockExternalExtensions stratégie est définie sur Enabled, l’installation de l’extension externe (par un logiciel tiers) est empêchée.

Remarque

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Google et utilisées conformément aux termes décrits dans la licence internationale Creative Commons Attribution 4.0. La page d’origine se trouve ici.

Cette œuvre est concédée sous licence creative commons attribution 4.0 international.