Manifest V3-migratiechecklist

Houd de voortgang van uw migratie bij

Opmerking: Manifest V3 wordt algemeen ondersteund in Chrome 88 of hoger. Voor extensiefuncties die in latere Chrome-versies zijn toegevoegd, raadpleegt u de API-referentiedocumentatie voor ondersteuningsinformatie. Als uw extensie een specifieke API vereist, kunt u een minimale Chrome-versie opgeven in het manifestbestand.

De onderstaande checklists zijn bedoeld om u te helpen uw migratiewerkzaamheden bij te houden. Ze definiëren taken die moeten worden voltooid met koppelingen naar instructies. Het migratiewerk is grofweg onderverdeeld in vijf categorieën, zoals beschreven in het Migratiesamenvatting .

Werk het manifest bij

Het bestand manifest.json vereist een iets andere indeling voor Manifest V3 dan voor Manifest V2. Op deze pagina worden wijzigingen beschreven die alleen van invloed zijn op het bestand manifest.json . Maar veel van de wijzigingen in scripts en pagina's vereisen ook wijzigingen in het manifest. Deze wijzigingen worden gedekt door de migratietaken waarvoor deze nodig zijn.

• Wijzig het manifestversienummer .
• Hostmachtigingen bijwerken .
• Update webtoegankelijke bronnen .

Migreren naar een servicemedewerker

Een servicemedewerker vervangt de achtergrond- of gebeurtenispagina van de extensie om ervoor te zorgen dat de achtergrondcode buiten de rode draad blijft. Hierdoor kunnen extensies alleen worden uitgevoerd wanneer dat nodig is, waardoor bronnen worden bespaard.

Lees voordat u begint de verschillen tussen achtergrondscripts en extensieservicemedewerkers .

• Werk het veld 'achtergrond' in het manifest bij
• Verplaats DOM- en vensteroproepen naar een document buiten het scherm
• Converteer localStorage naar chrome.storage.local
• Registreer luisteraars synchroon
• Vervang aanroepen naar XMLHttpRequest() door global fetch() .
• Aanhoudende staten
• Converteer timers naar alarmen
• De servicemedewerker in leven houden (in uitzonderlijke gevallen)

Update API-aanroepen

Sommige functies moeten worden vervangen door Manifest V3-equivalenten. Anderen moeten volledig worden verwijderd.

• Vervang tabs.executeScript() door scripting.executeScript() .
• Vervang tabs.insertCSS() en tabs.removeCSS() scripting.insertCSS() en scripting.removeCSS() .
• Vervang browseracties en pagina-acties door acties
• Vervang functies die een Manifest V2-achtergrondcontext verwachten .
• Vervang terugbelverzoeken door beloftes
• Vervang niet-ondersteunde API's

Vervang blokkerende luisteraars voor webverzoeken

In plaats van netwerkverzoeken programmatisch te lezen en te wijzigen (zoals u deed in Manifest V2), specificeert uw extensie regels die acties beschrijven die moeten worden uitgevoerd wanneer aan een bepaalde reeks voorwaarden wordt voldaan.

• Machtigingen bijwerken
• Maak declaratieve nettoverzoekregels

Nadat u de bovenstaande items heeft voltooid, wilt u wellicht enkele veelvoorkomende gebruiksscenario's bekijken:

• Blokkeer een enkele URL
• Redirect-meerdere-URL's
• Cookies blokkeren

Verbeter de beveiliging van extensies

Er zijn wijzigingen nodig om de beveiliging van extensies te verbeteren. Dit omvat het verwijderen van op afstand gehoste code, die niet langer wordt ondersteund.

• Verwijder de uitvoering van willekeurige tekenreeksen .
• Verwijder op afstand gehoste code
• Update het inhoudsbeveiligingsbeleid .
• Verwijder niet-ondersteunde inhoudsbeveiligingsbeleidswaarden

Publiceer uw Manifest V3-extensie

Na de conversie naar Manifest Versie 3 is het tijd om uw extensie vrij te geven in de Chrome Web Store. Afhankelijk van de aangebrachte wijzigingen kunt u een stapsgewijze uitrol overwegen. Met deze aanpak kunt u ervoor zorgen dat uw extensie eerst werkt zoals verwacht bij een beperkt publiek, voordat u deze vrijgeeft aan het hele gebruikersbestand.

• Publiceer een bètatestversie .
• Rol uw release geleidelijk uit .
• Plan voor beoordelingstijden .
• Aanvullende tips .