En règle générale, les utilisateurs de Chrome installent des extensions en accédant à la fiche d'une extension dans le Chrome Web Store et en l'installant directement depuis cette page. Toutefois, dans certains cas, d'autres flux d'installation peuvent être plus appropriés. Exemple :
- Une extension est associée à un autre logiciel et doit être installée chaque fois que l'utilisateur installe ce logiciel.
- Un administrateur réseau souhaite installer les mêmes extensions dans l'ensemble de son organisation.
Dans les cas précédents, Google Chrome accepte les méthodes d'installation d'extensions suivantes:
- À l'aide d'un fichier JSON de préférences (pour macOS X et Linux uniquement)
- Utilisation du registre Windows (pour Windows uniquement)
Les deux méthodes permettent d'installer une extension hébergée sur un update_URL
. Sous Windows et macOS, update_URL
doit pointer vers le Chrome Web Store. Lorsqu'une extension est installée à l'aide de ces méthodes, les utilisateurs Windows et macOS doivent l'activer à l'aide de la boîte de dialogue de confirmation suivante:
Sous Linux, le fichier de préférences peut pointer vers une extension du Chrome Web Store, une extension hébergée en externe ou un fichier d'extension CRX sur l'ordinateur de l'utilisateur. Les utilisateurs de Linux ne sont pas invités à activer l'extension. Celle-ci est installée automatiquement.
Avant de commencer
Installer depuis le Chrome Web Store
Si vous distribuez une extension hébergée dans le Chrome Web Store, vous devez d'abord publier l'extension. Notez ensuite les points suivants:
- L'URL de mise à jour :
https://clients2.google.com/service/update2/crx
. Cette URL renvoie vers le Chrome Web Store. - ID de l'extension : vous le trouverez dans l'URL du Chrome Web Store de l'extension.
Installer à partir d'un fichier CRX local
Si vous effectuez une distribution auprès des utilisateurs de Linux à partir d'un fichier local, vous devez empaqueter un fichier CRX et noter les informations suivantes:
L'ID de l'extension, qui se trouve sur la page de gestion des extensions
chrome://extensions
.La version de l'extension : elle s'affiche sur la page de gestion des extensions
chrome://extensions
ou dans le fichier manifeste JSON.
- L'emplacement du fichier CRX : il peut s'agir d'un répertoire local ou d'un partage réseau. Assurez-vous que le fichier est disponible pour la machine sur laquelle vous souhaitez installer l'extension.
Installer à partir d'un serveur personnel
Si vous distribuez une extension hébergée sur un serveur personnel pour les utilisateurs Linux, vous devez suivre les instructions d'installation des extensions sur Linux et noter les informations suivantes:
L'ID de l'extension, qui se trouve sur la page de gestion des extensions
chrome://extensions
.Chemin d'accès au fichier XML update_url : doit correspondre au chemin d'accès du champ
update_url
déclaré dans le fichier manifeste JSON.
Les exemples suivants supposent que la version est 1.0 et que l'ID d'extension est aaabbbcccdddeeefff.
Utiliser un fichier de préférences
macOS
- Créez un fichier JSON avec le nom de l'ID d'extension. Par exemple :
aaabbbcccdddeeefff.json
Placez-le dans l'un des dossiers suivants:
- Pour un utilisateur spécifique
~USERNAME/Library/Application Support/Google/Chrome/External Extensions/
- Pour tous les utilisateurs
/Library/Application Support/Google/Chrome/External Extensions/
Spécifiez l'URL de mise à jour avec le nom de champ "external_update_url". Par exemple :
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
Enregistrez le fichier JSON.
Lancez Google Chrome et accédez à chrome://extensions. L'extension devrait s'afficher.
Résoudre les problèmes d'autorisations Mac OS
Sur macOS, les fichiers d'extensions externes de tous les utilisateurs ne sont lus que si les autorisations du système de fichiers empêchent les utilisateurs non privilégiés de les modifier. Si aucune extension externe n'est installée lorsque Chrome est lancé, il se peut qu'il y ait un problème d'autorisation avec les fichiers de préférences des extensions externes. Pour vérifier si c'est le cas, procédez comme suit:
- Lancez le programme Console. Vous le trouverez sous /Applications/Utilitaires/Console.
- Si l'icône la plus à gauche de la console indique "Afficher la liste des journaux", cliquez dessus. Une deuxième colonne s'affiche à gauche.
- Cliquez sur "Messages de console" dans le volet de gauche.
- Recherchez la chaîne Can not read external extensions. En cas de problème lors de la lecture des fichiers d'extensions externes, un message d'erreur s'affiche. Recherchez un autre message d'erreur juste avant celui-ci, qui devrait expliquer le problème. Par exemple, si l'erreur suivante s'affiche : "Le chemin /Library/Application Support/Google/Chrome appartient au mauvais groupe", vous devez utiliser
chgrp
ou la boîte de dialogue "Get Info" (Obtenir des informations) du Finder pour définir le groupe Administrateur comme propriétaire du répertoire. - Une fois le problème résolu, relancez Chrome. Vérifiez que l'extension externe est maintenant installée. Il est possible qu'une seule erreur d'autorisation empêche Chrome de détecter une seconde erreur. Si l'extension externe n'a pas été installée, répétez ces étapes jusqu'à ce qu'aucune erreur ne s'affiche dans l'application Console.
Linux
- Créez un fichier JSON avec le nom de l'ID de l'extension. Exemple :
aaabbbcccdddeeefff.json
. Placez-le dans l'un des dossiers suivants:
/opt/google/chrome/extensions/
/usr/share/google-chrome/extensions/
La liste suivante décrit l'installation d'une extension à partir du Chrome Web Store, d'un fichier CRX ou d'un serveur personnel:
- Pour installer une extension du Chrome Web Store, spécifiez l'URL de mise à jour avec le nom de champ "external_update_url". Exemple :
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
. - Pour installer l'extension à partir d'un fichier CRX, spécifiez l'emplacement dans "external_crx" et la version dans "external_version". Exemple :
json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
. - Pour installer l'extension hébergée sur un serveur personnel, le champ "external_update_url" doit pointer vers le fichier XML, comme dans l'exemple suivant :
json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }
- Pour installer une extension du Chrome Web Store, spécifiez l'URL de mise à jour avec le nom de champ "external_update_url". Exemple :
Enregistrez le fichier JSON.
Lancez Google Chrome et accédez à l'adresse chrome://extensions. L'extension devrait s'afficher dans la liste.
Paramètres régionaux acceptés
Si vous souhaitez installer l'extension uniquement pour certains paramètres régionaux du navigateur, vous pouvez lister les paramètres régionaux pris en charge dans le champ nommé "supported_locales". Les paramètres régionaux peuvent spécifier des paramètres régionaux parents tels que "en". Dans ce cas, l'extension sera installée pour tous les paramètres régionaux anglais tels que "en-US", "en-GB", etc. Si un autre paramètre régional de navigateur est sélectionné et qu'il n'est pas compatible avec l'extension, les extensions externes seront désinstallées. Si la liste "supported_locales" est manquante, l'extension sera installée pour toutes les langues. Exemple :
{
"external_update_url": "https://clients2.google.com/service/update2/crx",
"supported_locales": [ "en", "fr", "de" ]
}
Utiliser le Registre Windows
Recherchez ou créez la clé suivante dans le Registre:
- Windows 32 bits
HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
- Windows 64 bits
HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions
Créez une clé (dossier) sous la clé Extensions avec le même nom que l'ID de votre extension. Exemple :
aaabbbcccdddeeefff
.Dans votre clé d'extension, créez une propriété "update_url" et définissez-la sur la valeur suivante :
json { "update_url": "https://clients2.google.com/service/update2/crx" }
Lancez Chrome.
Accédez à chrome://extensions. L'extension devrait s'afficher.
Mise à jour et désinstallation
Google Chrome analyse les entrées de métadonnées dans les préférences et le Registre à chaque démarrage du navigateur, et apporte les modifications nécessaires aux extensions externes installées hébergées sur le Chrome Web Store.
Pour mettre à jour une extension de fichier CRX locale vers une nouvelle version, mettez à jour le fichier, puis mettez à jour la version dans le fichier JSON des préférences.
Pour désinstaller votre extension (par exemple, si votre logiciel est désinstallé), supprimez votre fichier de préférences (par exemple, aaabbbcccdddeeefff.json
) ou les métadonnées du registre.
Questions fréquentes
Cette section répond aux questions fréquentes sur les extensions externes.
La préinstallation est-elle toujours prise en charge par Google Chrome ?
Oui, mais uniquement en tant qu'installation à partir d'un update_url
du Chrome Web Store, et non à partir d'un chemin d'accès CRX local. Pour en savoir plus, consultez les Règles relatives aux applications et aux extensions.
Quelles sont les erreurs courantes lors de l'installation avec le fichier de préférences ?
- Vous n'avez pas spécifié le même ID ou la même version que celle indiquée dans le fichier CRX.
- Le fichier JSON (par exemple,
aaabbbcccdddeeefff.json
) se trouve au mauvais endroit ou l'ID spécifié ne correspond pas à l'ID de l'extension. - Erreur de syntaxe dans le fichier JSON (oubli de séparer les entrées par une virgule ou de la fin d'une virgule).
- L'entrée du fichier JSON pointe vers le mauvais chemin d'accès au fichier CRX (ou le chemin d'accès est spécifié, mais aucun nom de fichier)
- Les barres obliques inverses du chemin UNC ne sont pas échappées. Par exemple,
"\\server\share\file"
est incorrect. Il devrait s'agir de"\\\\server\\share\\extension"
. - Problèmes d'autorisations sur un partage réseau.
Quelles sont les erreurs courantes lors de l'installation avec le Registre ?
- Vous n'avez pas spécifié le même ID que celui indiqué sur le Chrome Web Store.
- Clé créée au mauvais emplacement dans le registre.
- L'entrée de Registre pointe vers le mauvais chemin d'accès au fichier CRX dans le Chrome Web Store.
- Problèmes d'autorisations sur un partage réseau.
- Toutes les instances de Chrome ne sont pas fermées. Essayez de redémarrer votre ordinateur après avoir configuré le Registre.
Que se passe-t-il si l'utilisateur désinstalle l'extension ?
Si l'utilisateur désinstalle l'extension via l'UI, elle ne sera plus installée ni mise à jour à chaque démarrage. En d'autres termes, l'extension externe est ajoutée à la liste de blocage.
Comment sortir de la liste de blocage ?
Si l'utilisateur désinstalle votre extension, vous devez respecter cette décision. Toutefois, si vous (le développeur) avez désinstallé accidentellement votre extension via l'UI, vous pouvez supprimer la balise de liste de blocage en installant l'extension normalement via l'UI, puis en la désinstallant.