Suivez la progression de votre migration
Les checklists ci-dessous vous aideront à suivre votre travail de migration. Ils définissent les tâches qui doivent être accomplies à l'aide de liens vers des instructions. Le travail de migration est généralement divisé en cinq catégories, comme indiqué dans le récapitulatif de la migration.
Mettre à jour le fichier manifeste
Le format du fichier manifest.json
est légèrement différent pour Manifest V3 et Manifest V2. Cette page décrit les modifications qui ne concernent que le fichier manifest.json
. Cependant, de nombreuses modifications apportées aux scripts et aux pages nécessitent également des modifications au niveau 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.
- Mettez à jour les autorisations d'hôte.
- Mettre à jour les ressources accessibles sur le Web
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. Cela permet aux extensions de s'exécuter uniquement en cas de besoin, ce qui permet d'économiser des ressources.
Avant de commencer, découvrez 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()
globales. - Conserver les états
- Convertir des minuteurs en alarmes
- Maintenir le service worker en vie (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 complètement supprimées.
- Remplacez
tabs.executeScript()
parscripting.executeScript()
. - Remplacement de
tabs.insertCSS()
ettabs.removeCSS()
parscripting.insertCSS()
etscripting.removeCSS()
. - Remplacer les actions du navigateur et les actions sur la 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 bloquants
Au lieu de lire les requêtes réseau et de les modifier par programmation (comme vous l'avez fait dans Manifest V2), votre extension spécifie des règles décrivant les actions à effectuer lorsqu'un ensemble donné de conditions est rempli.
Une fois que vous avez suivi les étapes ci-dessus, nous vous conseillons d'examiner quelques cas d'utilisation courants:
Améliorez la sécurité des extensions
Vous devez apporter des modifications pour renforcer la sécurité des extensions. Cela inclut la suppression du code hébergé à distance, qui n'est plus accepté.
- Supprimer l'exécution des chaînes arbitraires.
- Supprimer le code hébergé à distance
- Mettre à jour la stratégie de sécurité du contenu
- Supprimer les valeurs de la stratégie Content Security Policy non acceptées
Publier votre extension Manifest V3
Une fois la conversion vers Manifest version 3 terminée, vous pouvez publier votre extension sur le Chrome Web Store. En fonction des modifications apportées, envisagez un déploiement par étapes. Cette approche vous permet de vous assurer que votre extension fonctionne comme prévu avec une audience limitée, avant de la proposer à l'ensemble de la base d'utilisateurs.