Houd de voortgang van uw migratie bij.
De volgende checklists helpen u bij het bijhouden van uw migratiewerkzaamheden. Ze beschrijven de taken die moeten worden voltooid en bevatten links naar instructies. Migratiewerkzaamheden zijn grofweg onderverdeeld in vijf categorieën, zoals beschreven in het migratieoverzicht .
Werk het manifest bij
Het manifest.json bestand vereist een iets ander formaat voor Manifest V3 dan voor Manifest V2. Deze pagina beschrijft wijzigingen die alleen van invloed zijn op het manifest.json bestand. Veel wijzigingen aan scripts en pagina's vereisen echter ook aanpassingen aan het manifest. Deze wijzigingen worden behandeld in de migratietaken die ze vereisen.
- Wijzig het versienummer van het manifest .
- Hostmachtigingen bijwerken .
- Webtoegankelijke bronnen bijwerken .
Overstappen naar een baan als servicemedewerker
Een service worker vervangt de achtergrond- of gebeurtenispagina van de extensie om ervoor te zorgen dat achtergrondcode niet op de hoofdthread wordt uitgevoerd. Hierdoor worden extensies alleen uitgevoerd wanneer dat nodig is, wat resources bespaart.
Voordat je begint, lees eerst over de verschillen tussen achtergrondscripts en extension service workers .
- Werk het veld "achtergrond" in het manifest bij.
- Verplaats DOM- en window-aanroepen naar een offscreen-document.
- Converteer localStorage naar chrome.storage.local
- Registreer luisteraars synchroon
- Vervang aanroepen naar
XMLHttpRequest()door globalefetch(). - Volhardende staten
- Zet timers om in alarmen.
- Houd de hulpverlener in leven (in uitzonderlijke gevallen).
Update API-aanroepen
Sommige functies moeten worden vervangen door equivalenten uit Manifest V3. Andere moeten volledig worden verwijderd.
- Vervang
tabs.executeScript()doorscripting.executeScript(). - Vervang
tabs.insertCSS()entabs.removeCSS()doorscripting.insertCSS()enscripting.removeCSS(). - Vervang Browseracties en Pagina-acties door Acties
- Vervang functies die een Manifest V2-achtergrondcontext verwachten .
- Vervang callbacks door promises.
- Vervang niet-ondersteunde API's
Vervang blokkerende webverzoeklisteners.
In plaats van programmatisch netwerkverzoeken 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 bovenstaande stappen hebt voltooid, kunt u een aantal veelvoorkomende gebruiksscenario's bekijken:
Verbeter de beveiliging van extensies
Er zijn wijzigingen nodig om de beveiliging van extensies te verbeteren. Dit houdt onder meer in dat code die op afstand wordt gehost, wordt verwijderd, aangezien deze niet langer wordt ondersteund.
- Voorkom de uitvoering van willekeurige tekenreeksen .
- Verwijder extern gehoste code
- Update het contentbeveiligingsbeleid .
- Verwijder niet-ondersteunde waarden voor het inhoudsbeveiligingsbeleid.
Publiceer je Manifest V3-extensie
Na de overstap naar Manifest versie 3 is het tijd om je extensie in de Chrome Web Store te publiceren. Afhankelijk van de aangebrachte wijzigingen kun je een stapsgewijze uitrol overwegen. Met deze aanpak kun je er eerst voor zorgen dat je extensie naar behoren werkt bij een beperkt aantal gebruikers, voordat je deze voor iedereen beschikbaar stelt.