Houd de voortgang van uw migratie bij
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.
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 globalfetch(). - 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()doorscripting.executeScript(). - Vervang
tabs.insertCSS()entabs.removeCSS()scripting.insertCSS()enscripting.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.
Nadat u de bovenstaande items heeft voltooid, wilt u wellicht enkele veelvoorkomende gebruiksscenario's bekijken:
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.