Migrer vers Manifest V3

Guide de conversion des extensions Manifest V2 en extensions Manifest V3.

Cette section vous aide à mettre à niveau une extension de Manifest V2 vers Manifest V3, la dernière version de la plate-forme d'extensions Chrome. Le travail de migration est globalement divisé en catégories ci-dessous. Pour vous aider à suivre votre travail, nous avons mis à votre disposition une liste de contrôle récapitulant le contenu de ces documents. Vous pouvez accéder au contenu via la checklist ou examiner le contenu en détail. Les deux chemins se terminent par une extension mise à jour.

  • Mettez à jour le fichier manifeste : le manifest.json doit être spécifique à la version 3. Cette section décrit les modifications qui peuvent être effectuées vous-même. Les modifications du fichier manifeste liées au code sont décrites avec les modifications de code compatibles.
  • Migrer vers un service worker : un service worker remplace l'arrière-plan ou la page d'événements de l'extension pour s'assurer que le code d'arrière-plan reste hors du thread principal et peut nuire aux performances. Cette modification nécessite également de déplacer le DOM, la fenêtre et certains appels d'API d'extension vers 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 considérablement dégrader 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 du 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. Outre une politique de sécurité du contenu améliorée, il n'est plus possible d'héberger du code à distance ni d'exécuter des chaînes arbitraires.
  • Publiez votre extension : cette section explique comment effectuer un déploiement par étapes pour vous assurer que votre extension Manifest V3 fonctionne comme prévu en la testant d'abord auprès d'une audience limitée.

Nous disposons également d'une extension Manifest Converter. Elle ne fait pas tout pour vous, mais elle vous aidera à démarrer. Le fichier README du convertisseur décrit les modifications apportées par l'outil.

Conserver l'ensemble de fonctionnalités actuel

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 une autorisation. Votre extension sera alors désactivée jusqu'à ce que l'utilisateur accepte les nouvelles autorisations. Consultez Bonnes pratiques concernant les avertissements concernant les autorisations 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 des appels d'API, il est possible que les fonctionnalités de remplacement ne soient disponibles dans Chrome qu'après la version 88. Les pages de référence de l'API contiennent des informations d'assistance pour chaque membre de l'API. Si vous découvrez 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 la plupart sont utilisables à la fois dans Manifest V2 et Manifest V3. Vous n'êtes pas obligé de les utiliser lors d'une conversion. Toutefois, lorsqu'ils remplacent d'anciennes fonctionnalités, il est préférable de les utiliser plutôt que celles qu'ils remplacent, en sachant que les fonctionnalités remplacées finiront par être abandonnées et supprimées.