Migrer vers Manifest V3

Guide pour convertir les extensions Manifest V2 en extensions Manifest V3.

Cette section vous aide à migrer une extension de Manifest V2 vers Manifest V3, la dernière version de la plate-forme d'extensions Chrome. Le travail de migration est divisé en deux grandes catégories. Pour vous aider à suivre votre travail, nous avons fourni une checklist récapitulant le contenu de ces documents. Vous pouvez accéder au contenu à l'aide de la checklist ou l'explorer directement. Les deux parcours se terminent par une extension mise à niveau.

  • Mettez à jour le fichier manifeste : manifest.json doit être spécifique à V3. Les modifications qui peuvent être apportées seules sont décrites dans cette section. Les modifications apportées au fichier manifeste en lien avec le code sont décrites avec les modifications de code qu'elles prennent en charge.
  • Migrer vers un service worker : un service worker remplace la page d'arrière-plan ou d'événement de l'extension pour s'assurer que le code d'arrière-plan reste en dehors du thread principal, où il peut nuire aux performances. Ce changement nécessite également de déplacer les appels d'API DOM, window et de certaines extensions dans des documents hors écran.
  • Appels d'API de mise à jour : certains appels d'API doivent être remplacés par des équivalents plus modernes.
  • Remplacer les écouteurs de requêtes Web bloquantes : le blocage ou la modification des requêtes réseau dans Manifest V2 peut dégrader considérablement les performances et nécessiter un accès excessif aux données utilisateur sensibles. L'API Declarative Net Request permet aux extensions de bloquer ou de modifier le contenu Web avec moins d'autorisations et sans nuire aux performances.
  • Améliorer la sécurité des extensions : Manifest V3 améliore la sécurité des extensions de plusieurs façons. En plus d'une règle de sécurité du contenu améliorée, la compatibilité avec le code hébergé à distance et l'exécution de chaînes arbitraires est supprimée.
  • Publier votre extension : cette section explique comment publier votre extension Manifest V3 par étapes pour vous assurer qu'elle fonctionne comme prévu en la testant d'abord auprès d'une audience limitée.

Nous proposons également un convertisseur de fichier manifeste d'extension. Il ne fera pas tout pour vous, mais il vous aidera à vous lancer. Le fichier README du convertisseur décrit les modifications apportées par l'outil.

Conserver l'ensemble actuel de fonctionnalités

Pour réduire le risque de problèmes ou de bugs inattendus, nous vous recommandons de ne pas ajouter de nouvelles fonctionnalités lors de la migration. Par exemple, l'ajout d'une fonctionnalité nécessitant de nouvelles autorisations peut déclencher un avertissement concernant les autorisations, ce qui désactivera votre extension jusqu'à ce que l'utilisateur accepte les nouvelles autorisations. Consultez les bonnes pratiques concernant les avertissements d'autorisation pour découvrir d'autres façons d'ajouter des autorisations sans afficher d'avertissement.

Manifest V3 est généralement compatible avec Chrome 88 ou version ultérieure. Lorsque vous mettez à jour les appels d'API, vous constaterez peut-être que les fonctionnalités de remplacement n'ont pas été déployées dans Chrome avant la version 88. Les pages de documentation de référence de l'API contiennent des informations d'assistance pour les membres individuels de l'API. Si vous constatez que vous avez besoin de l'une de ces fonctionnalités, vous pouvez spécifier une version minimale de Chrome dans le fichier manifeste.

Nouvelles fonctionnalités de la plate-forme d'extensions

Depuis la sortie de Manifest V3, nous avons continué à ajouter de nouvelles fonctionnalités, dont beaucoup sont utilisables à la fois dans Manifest V2 et Manifest V3. Vous n'êtes pas obligé de les utiliser lors de la conversion. Toutefois, lorsqu'elles remplacent d'anciennes fonctionnalités, vous devez les privilégier et vous attendre à ce que les fonctionnalités remplacées soient à terme abandonnées et supprimées.