Migreren naar Manifest V3

Een handleiding voor het converteren van Manifest V2-extensies naar Manifest V3-extensies.

In dit gedeelte kunt u een extensie upgraden van Manifest V2 naar Manifest V3, de nieuwste versie van het Chrome Extensions-platform. De migratie is grofweg onderverdeeld in de volgende categorieën. Om u te helpen uw werk bij te houden, hebben we een checklist gemaakt met een samenvatting van de inhoud van deze documenten. U kunt de inhoud raadplegen via de checklist of direct in de documenten duiken. Beide trajecten leiden tot een geüpgrade extensie.

  • Het manifest bijwerken — Het manifest.json moet specifiek zijn voor V3. Wijzigingen die afzonderlijk kunnen worden doorgevoerd, worden in dit gedeelte beschreven. Manifestwijzigingen die betrekking hebben op code worden beschreven samen met de codewijzigingen die ze ondersteunen.
  • Migreer naar een service worker — Een service worker vervangt de achtergrond- of gebeurtenispagina van de extensie om ervoor te zorgen dat achtergrondcode niet op de hoofdthread draait, waar dit de prestaties negatief kan beïnvloeden. Deze wijziging vereist ook dat DOM-, venster- en bepaalde API-aanroepen van de extensie naar offscreen-documenten worden verplaatst.
  • API-aanroepen bijwerken — Sommige API-aanroepen moeten worden vervangen door modernere equivalenten.
  • Vervang blokkerende webverzoeklisteners — Het blokkeren of wijzigen van netwerkverzoeken in Manifest V2 kon de prestaties aanzienlijk verslechteren en vereiste buitensporige toegang tot gevoelige gebruikersgegevens. De Declarative Net Request API stelt extensies in staat om webinhoud te blokkeren of te wijzigen met minder machtigingen en zonder de prestaties te belemmeren.
  • Verbeterde extensiebeveiliging — Manifest V3 verbetert de extensiebeveiliging op verschillende manieren. Naast een verbeterd contentbeveiligingsbeleid is de ondersteuning voor extern gehoste code en de uitvoering van willekeurige tekenreeksen verwijderd.
  • Je extensie publiceren — In dit gedeelte wordt beschreven hoe je je Manifest V3-extensie stapsgewijs kunt uitbrengen om ervoor te zorgen dat deze naar behoren werkt door hem eerst met een beperkt publiek te testen.

We hebben ook een Extension Manifest Converter . Deze doet niet alles voor je, maar je kunt er wel mee aan de slag. In de README van de converter wordt beschreven wat de tool precies aanpast.

Behoud de huidige set functies.

Om de kans op onverwachte problemen of bugs te verkleinen, raden we aan geen nieuwe functionaliteit toe te voegen tijdens de migratie. Het toevoegen van een functie die nieuwe machtigingen vereist, kan bijvoorbeeld een waarschuwing over machtigingen veroorzaken , waardoor uw extensie wordt uitgeschakeld totdat de gebruiker de nieuwe machtigingen accepteert. Zie de beste werkwijzen voor waarschuwingen over machtigingen voor meer informatie over andere manieren om machtigingen toe te voegen zonder een waarschuwing weer te geven.

Manifest V3 wordt over het algemeen ondersteund in Chrome 88 of later. Bij het bijwerken van API-aanroepen kan het voorkomen dat vervangende functies pas na versie 88 in Chrome beschikbaar zijn gekomen. De API-referentiepagina's bevatten ondersteuningsinformatie voor individuele API-leden. Als u een van deze functies nodig hebt, kunt u een minimale Chrome-versie specificeren in het manifestbestand.

Nieuwe uitbreidingsplatformfuncties

Sinds de release van Manifest V3 hebben we continu nieuwe functies toegevoegd , waarvan vele zowel in Manifest V2 als in Manifest V3 bruikbaar zijn. U bent niet verplicht om deze te gebruiken bij de conversie; wanneer ze echter oudere functies vervangen, is het raadzaam om de nieuwe functies te verkiezen boven de vervangen functies en er rekening mee te houden dat de vervangen functies uiteindelijk zullen worden afgeschreven en verwijderd.