Suivre la progression de votre migration
Les checklists suivantes vous aident à suivre votre travail de migration. Ils définissent les tâches à accomplir et fournissent des liens vers les instructions. Le travail de migration est divisé en cinq grandes catégories, comme décrit dans le Résumé de la migration.
Mettre à jour le fichier manifeste
Le format du fichier manifest.json est légèrement différent pour Manifest V3 que pour Manifest V2. Cette page décrit les modifications qui n'affectent que le fichier manifest.json. Toutefois, de nombreuses modifications apportées aux scripts et aux pages nécessitent également des modifications du fichier manifeste. Ces modifications sont couvertes par les tâches de migration qui les nécessitent.
- Modifiez le numéro de version du fichier manifeste.
- Modifiez les autorisations de l'organisateur.
- Mettez à jour les ressources accessibles sur le Web.
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. Cela permet aux extensions de ne s'exécuter que lorsque cela est nécessaire, ce qui économise des ressources.
Avant de commencer, lisez les informations sur les différences entre les scripts d'arrière-plan et les service workers d'extension.
- Mettre à jour le champ "background" dans le fichier manifeste
- Déplacer les appels DOM et de fenêtre vers un document hors écran
- Convertir localStorage en chrome.storage.local
- Enregistrer les écouteurs de manière synchrone
- Remplacez les appels à
XMLHttpRequest()par desfetch()globaux. - Persister les états
- Convertir des minuteurs en alarmes
- Maintenir le service worker actif (dans des cas exceptionnels)
Mettre à jour les appels d'API
Certaines fonctionnalités doivent être remplacées par des équivalents Manifest V3. D'autres doivent être supprimés complètement.
- Remplacez
tabs.executeScript()parscripting.executeScript(). - Remplacez
tabs.insertCSS()ettabs.removeCSS()parscripting.insertCSS()etscripting.removeCSS(). - Remplacer les actions de navigateur et de page par des actions
- Remplacez les fonctions qui attendent un contexte d'arrière-plan Manifest V2.
- Remplacer les rappels par des promesses
- Remplacer les API non compatibles
Remplacer les écouteurs de requêtes Web bloquantes
Au lieu de lire et de modifier les requêtes réseau de manière programmatique (comme vous l'avez fait dans Manifest V2), votre extension spécifie des règles qui décrivent les actions à effectuer lorsqu'un ensemble de conditions donné est rempli.
Après avoir effectué les étapes ci-dessus, vous pouvez consulter quelques cas d'utilisation courants :
Améliorer la sécurité des extensions
Des modifications sont nécessaires pour améliorer la sécurité des extensions. Cela inclut la suppression du code hébergé à distance, qui n'est plus accepté.
- Supprimez l'exécution de chaînes arbitraires.
- Supprimer le code hébergé à distance
- Mettez à jour la règle de sécurité du contenu.
- Supprimer les valeurs non acceptées de la règle de sécurité du contenu
Publier votre extension Manifest V3
Une fois la conversion vers Manifest Version 3 effectuée, il est temps de publier votre extension sur le Chrome Web Store. En fonction des modifications apportées, envisagez un déploiement progressif. Cette approche vous permet de vous assurer que votre extension fonctionne comme prévu auprès d'une audience limitée avant de la déployer auprès de l'ensemble des utilisateurs.