Installer une extension Chrome manuellement : ZIP, CRX et limites


Vous avez récupéré une extension Chrome sous forme de fichier ZIP ou CRX, mais le navigateur refuse de l’installer. Avant de chercher à forcer le chargement, identifiez ce que vous avez téléchargé : une archive du code source, un dossier prêt à tester et un paquet de distribution ne s’utilisent pas de la même manière.

Le bouton « Charger l’extension non empaquetée » accepte un dossier de développement contenant un fichier manifest.json. Il sert à tester du code de confiance. Ce n’est ni une validation de sécurité, ni un moyen de rendre compatible une extension abandonnée. La procédure ci-dessous concerne Chrome sur ordinateur ; les autres navigateurs Chromium peuvent appliquer des règles différentes.

ZIP, CRX ou dossier : choisir la bonne méthode

Le nom du fichier ne suffit pas à savoir si l’extension fonctionnera. Un ZIP peut contenir un projet complet, sa documentation et des outils de compilation, sans fournir directement les fichiers que Chrome doit charger.

Ce que vous avezCe qu’il faut vérifierLa suite adaptée
Une extension proposée dans le Chrome Web StoreL’identité de l’éditeur et les autorisations demandéesUtiliser sa fiche officielle plutôt qu’une copie récupérée ailleurs
Un ZIP préparé pour un chargement localLa notice du développeur et le dossier contenant le manifesteExtraire l’archive, puis charger le dossier indiqué
Un ZIP du code sourceLes instructions de préparation du projetObtenir une version prête à tester ou suivre le processus de développement documenté
Un fichier CRXSa provenance et le mode de distribution prévuDemander la version officielle appropriée ; ne pas supposer qu’un renommage suffira

Google distingue le chargement local pour le développement de la distribution aux utilisateurs. Sur Windows et macOS, l’installation d’une extension auto-hébergée passe par des règles d’entreprise. Linux autorise aussi l’installation manuelle de paquets qui ne viennent pas du Web Store. Ces différences figurent dans la documentation officielle sur la distribution des extensions Chrome.

Un CRX n’est donc pas systématiquement inutilisable. Certains outils savent en extraire les fichiers, parfois après renommage en ZIP. Mais changer le suffixe ne convertit pas son contenu et ne garantit ni l’extraction, ni l’acceptation par Chrome. Pour développer ou examiner une extension, demandez de préférence les fichiers non empaquetés à son auteur.

Préparer les fichiers avant d’ouvrir Chrome

Commencez par le site ou le dépôt que l’éditeur présente comme officiel. Une archive jointe à un message d’assistance, même accompagnée d’un logo familier, ne prouve pas son origine. La présence du projet sur une plateforme connue ne remplace pas cette vérification.

Après extraction du ZIP, lisez le fichier README ou les instructions d’installation. Si le projet prévoit une compilation, le dossier à charger peut s’appeler dist ou autrement : retenez le chemin indiqué, pas un nom supposé universel. N’exécutez pas une série de commandes trouvées dans un commentaire pour simplement faire disparaître une erreur.

Le fichier manifest.json décrit notamment le nom, la version et les composants de l’extension. Il doit se trouver directement dans le dossier que vous sélectionnerez. Un manifeste présent ne suffit toutefois pas : les scripts, images et pages auxquels il fait référence doivent aussi exister aux chemins attendus.

Prenons une arborescence simple : MonExtension/extension/manifest.json. Vous devez sélectionner le dossier extension, pas MonExtension. Ne déplacez pas uniquement le manifeste au niveau supérieur pour satisfaire Chrome : vous risqueriez de casser les références vers les autres fichiers.

Charger une extension non empaquetée

Sur un poste professionnel, arrêtez la procédure si l’organisation interdit le chargement. Demandez au service informatique une version approuvée ou un déploiement adapté ; ne modifiez pas les règles de gestion pour contourner le refus.

Une fois la provenance et les fichiers vérifiés, placez le dossier dans un emplacement durable. Évitez un répertoire temporaire que vous comptez vider après l’installation.

  1. Saisissez chrome://extensions/ dans la barre d’adresse de Chrome.
  2. Activez Mode développeur.
  3. Cliquez sur Charger l’extension non empaquetée.
  4. Sélectionnez le dossier de l’extension, celui qui contient directement manifest.json.
  5. Vérifiez le nom et la version affichés sur sa fiche.

La présence de cette fiche confirme que Chrome a chargé l’extension, pas que toutes ses fonctions marchent. Essayez l’action attendue sur une page adaptée, avec des données sans importance. Par exemple, pour un outil qui reformate du texte, utilisez quelques lignes fictives avant de lui confier un document professionnel.

Si le chargement échoue, conservez le message exact. Modifier plusieurs paramètres à la fois rend le diagnostic plus difficile : vous ne saurez plus si le problème venait du dossier, du code ou d’une restriction du navigateur.

Une erreur de manifeste ne se traite pas comme un blocage de sécurité

Le manifeste manque ou Chrome refuse de le lire

Revenez au dossier sélectionné. Le fichier est-il réellement présent, avec le nom manifest.json ? L’archive contient-elle plusieurs niveaux de dossiers ? Si le manifeste existe, l’erreur peut signaler un champ absent ou un contenu invalide. Relevez la ligne ou la propriété indiquée par Chrome et transmettez-la au développeur.

Un exemple : un message concernant un script introuvable demande de vérifier les fichiers livrés et leurs chemins. Désactiver l’antivirus n’ajouterait pas le script manquant ; cela ne répondrait pas au diagnostic.

L’extension repose encore sur Manifest V2

Chrome 139 et les versions suivantes ne prennent plus en charge Manifest V2, y compris l’ancienne exception d’entreprise. Une archive conservée depuis plusieurs années peut donc être complète et néanmoins incompatible avec votre navigateur actuel.

Ouvrir le manifeste dans un éditeur de texte permet de repérer la valeur de manifest_version. Si elle vaut 2, recherchez une version maintenue auprès de l’auteur. Remplacer simplement 2 par 3 ne réalise pas la migration. Le développeur peut devoir revoir le code d’arrière-plan, les API utilisées et les autorisations. Ne rétrogradez pas Chrome pour conserver cet ancien module.

La fiche apparaît, mais la fonction attendue ne marche pas

Consultez le bouton Erreurs lorsqu’il apparaît sur la fiche. Un composant d’arrière-plan qui échoue au démarrage et une autorisation absente ne conduisent pas à la même correction. Pour demander de l’aide, indiquez la version de Chrome, celle de l’extension, l’action effectuée et le message relevé, sans transmettre de données personnelles.

L’absence d’erreur visible n’atteste pas non plus que tout fonctionne. Certaines erreurs se lisent dans les outils de développement du composant concerné. Si vous n’êtes pas l’auteur du code, mieux vaut lui fournir un cas reproductible que modifier des permissions au hasard.

Examiner les accès avant d’utiliser l’extension au quotidien

Une extension peut agir sur des pages auxquelles vous êtes connecté. La question utile est donc : de quels accès a-t-elle besoin pour rendre le service annoncé ?

  • Comparez les permissions demandées avec la fonction décrite par l’éditeur.
  • Examinez les sites visés par les autorisations d’hôte et les scripts injectés.
  • Dans Détails, limitez l’accès aux sites lorsque Chrome propose cette possibilité et que l’usage le permet.
  • N’accordez pas l’accès aux fichiers locaux ou à la navigation privée sans besoin identifié.

Un outil destiné à un seul site qui demande un accès très large mérite une explication. Ce décalage ne prouve pas une intention malveillante, mais vous n’avez pas à accepter un risque inexpliqué. Inversement, une liste courte de permissions ne certifie pas l’innocuité du code.

Le mode développeur n’accorde pas une confiance particulière à l’extension. Si une protection signale ses fichiers, ne désactivez pas l’antivirus et n’ajoutez pas d’exclusion globale pour poursuivre le test. Conservez l’alerte et faites vérifier le paquet par son éditeur ou votre service informatique.

Mettre à jour, désactiver ou retirer la version locale

Le bouton de rechargement relit les fichiers du dossier déjà chargé. Il ne recherche pas une nouvelle archive dans vos téléchargements. Si vous extrayez une version ailleurs et rechargez l’ancienne fiche, vous continuez à utiliser l’ancien emplacement.

Avant une modification, sauvegardez votre code et exportez les réglages utiles si l’extension le permet. Appliquez ensuite la procédure de mise à jour du projet au dossier chargé. Après rechargement, contrôlez la version et refaites le test fonctionnel. Lorsque des scripts agissent dans une page web, rechargez également cette page pour tester leur nouvelle version.

Ne confondez pas sauvegarde du dossier et sauvegarde des données de l’extension. Les réglages peuvent résider dans le profil Chrome. La désinstallation efface notamment les données de storage.local ; un simple rechargement efface celles de storage.session. Une promesse générale de conservation serait donc trompeuse.

Pour interrompre un essai, désactivez l’extension depuis sa fiche. Pour la désinstaller, choisissez Supprimer et confirmez, après avoir récupéré les données à conserver. Masquer son icône dans la barre d’outils ne la désinstalle pas.

Une extension interne utilisée par plusieurs personnes a aussi besoin d’un responsable pour ses mises à jour et son retrait, pas seulement d’une méthode pour réussir la première installation.

Laisser un commentaire