Utiliser d'autres méthodes d'installation

En général, les utilisateurs de Chrome installent les extensions en consultant leur fiche sur le Chrome Web Store et en installant l'extension directement à partir de 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 cet autre 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 prend en charge les méthodes d'installation d'extensions suivantes:

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 de Windows et de macOS doivent l'activer dans la boîte de dialogue de confirmation suivante:

Avertissement concernant les extensions externes

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, qui est installée automatiquement.

Avant de commencer

Installer depuis le Chrome Web Store

Si vous distribuez une extension hébergée sur le Chrome Web Store, vous devez d'abord la publier. Notez ensuite les éléments suivants:

  • L'URL de mise à jour : https://clients2.google.com/service/update2/crx. Cette URL pointe vers le Chrome Web Store.
  • L'ID de l'extension, qui se trouve dans l'URL Chrome Web Store de l'extension.

ID de l'article sur le Chrome Web Store

Installer à partir d'un fichier CRX local

Si vous distribuez l'application aux utilisateurs Linux à partir d'un fichier local, vous devez empaqueter un fichier CRX et prendre note des informations suivantes:

  • L'ID d'extension (disponible sur la page de gestion des extensions chrome://extensions).

  • La version de l'extension : elle apparaît sur la page de gestion des extensions chrome://extensions ou dans le fichier manifeste JSON.

Comment trouver l'ID et la version de l'extension

  • 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 depuis un serveur personnel

Si vous distribuez une extension hébergée sur un serveur personnel pour les utilisateurs de Linux, vous devez suivre les instructions pour installer des extensions sur Linux et prendre note des informations suivantes:

  • L'ID d'extension (disponible sur la page de gestion des extensions chrome://extensions).

  • Le chemin d'accès au fichier XML de mise à jour_url : il doit correspondre au chemin 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

  1. Créez un fichier JSON portant le nom de l'ID d'extension. Par exemple : aaabbbcccdddeeefff.json

  2. 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/

  3. 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" }

  4. Enregistrez le fichier JSON.

  5. Lancez Google Chrome et accédez à chrome://extensions. L'extension devrait apparaître dans la liste.

Résoudre les problèmes d'autorisation de Mac OS

Sous 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 lors du lancement de Chrome, il est possible qu'il y ait un problème d'autorisation avec les fichiers de préférences des extensions externes. Pour le vérifier, procédez comme suit:

  1. Lancez le programme Console. Vous le trouverez dans /Applications/Utilitaires/Console.
  2. Si l'icône la plus à gauche de la console indique "Show Log List" (Afficher la liste des journaux), cliquez dessus. Une deuxième colonne apparaît à gauche.
  3. Cliquez sur "Messages de la console" dans le volet de gauche.
  4. Recherchez la chaîne Impossible de lire les extensions externes. 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 : "Path /Library/Application Support/Google/Chrome is created by the wrong group", vous devez utiliser chgrp ou la boîte de dialogue "Get Info" (Obtenir des informations) du Finder pour remplacer le propriétaire du groupe de l'annuaire par le groupe "Administrator" (Administrateur).
  5. Une fois le problème résolu, relancez Chrome. Vérifiez que l'extension externe est bien installée. Il est possible qu'une 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

  1. Créez un fichier JSON portant le nom de l'ID d'extension. Exemple : aaabbbcccdddeeefff.json.

  2. Placez-le dans l'un des dossiers suivants:

    • /opt/google/chrome/extensions/
    • /usr/share/google-chrome/extensions/

  3. La liste suivante décrit l'installation d'extensions à partir du Chrome Web Store, d'un fichier CRX ou d'un serveur personnel:

    • Pour installer une extension 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" }

  4. Enregistrez le fichier JSON.

  5. Lancez Google Chrome et accédez à chrome://extensions. L'extension devrait apparaître dans la liste.

Paramètres régionaux compatibles

Si vous souhaitez installer l'extension uniquement pour certains paramètres régionaux de navigateur, vous pouvez lister les paramètres régionaux compatibles dans le champ "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 du navigateur n'est pas compatible avec l'extension, les extensions externes seront désinstallées. Si la liste "supported_locales" n'apparaît pas, l'extension est installée pour tous les paramètres régionaux. Exemple :

{
  "external_update_url": "https://clients2.google.com/service/update2/crx",
  "supported_locales": [ "en", "fr", "de" ]
}

Utiliser le registre Windows

  1. 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

  2. Créez sous la clé Extensions une clé (dossier) portant le même nom que l'ID de votre extension. Exemple : aaabbbcccdddeeefff.

  3. 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" }

  4. Lancez Chrome.

  5. Accédez à chrome://extensions. L'extension devrait apparaître dans la liste.

Mise à jour et désinstallation

À chaque démarrage du navigateur, Google Chrome analyse les entrées de métadonnées dans les préférences et le registre, et apporte les modifications nécessaires aux extensions externes installées qui sont hébergées dans 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 de 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 concernant les extensions externes.

La fonctionnalité de "préinstallation" est-elle toujours disponible dans Google Chrome ?

Oui, mais uniquement lors d'une 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 l'article 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 ceux indiqués dans le fichier CRX.
  • Le fichier JSON (par exemple, aaabbbcccdddeeefff.json) ne se trouve pas au bon endroit ou l'ID spécifié ne correspond pas à l'ID d'extension.
  • Erreur de syntaxe dans le fichier JSON (oubli de séparer les entrées par une virgule ou absence d'une virgule à la fin).
  • L'entrée du fichier JSON pointe vers le mauvais chemin d'accès au fichier CRX (ou chemin spécifié, mais sans nom de fichier)
  • Les barres obliques inverses ne sont pas échappées dans le chemin UNC. Par exemple, "\\server\share\file" est incorrect. Il devrait s'agir de "\\\\server\\share\\extension".
  • Problèmes d'autorisation sur un partage réseau.

Quelles sont les erreurs courantes lors de l'installation avec le Registre ?

  • L'ID indiqué n'est pas celui qui figure sur le Chrome Web Store.
  • Clé créée au mauvais emplacement dans le registre.
  • L'entrée du Registre renvoie vers le mauvais chemin d'accès au fichier CRX dans le Chrome Web Store.
  • Problèmes d'autorisation 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'interface utilisateur, elle ne sera plus installée ni mise à jour à chaque démarrage. En d'autres termes, l'extension externe figure sur la liste de blocage.

Comment puis-je me retirer 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 accidentellement désinstallé votre extension via l'interface utilisateur, vous pouvez supprimer la balise de liste de blocage en installant l'extension normalement via l'interface utilisateur, puis en la désinstallant.