Migreren naar Manifest V3

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

In deze sectie kunt u een extensie upgraden van Manifest V2 naar Manifest V3, de nieuwste versie van het Chrome Extensions-platform. Migratiewerk is grofweg onderverdeeld in de onderstaande categorieën. Om u te helpen uw werk bij te houden, hebben we een checklist verstrekt met een samenvatting van de inhoud van deze documenten. Je kunt via de checklist toegang krijgen tot de inhoud, of je verdiepen in de inhoud. Beide paden eindigen met een geüpgradede extensie.

  • Update het manifest : het manifest.json moet specifiek zijn voor V3. Wijzigingen die afzonderlijk kunnen worden aangebracht, worden in dit gedeelte beschreven. Duidelijke wijzigingen met betrekking tot code worden beschreven met de codewijzigingen die ze ondersteunen.
  • 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 waar dit de prestaties kan schaden. Deze wijziging vereist ook het verplaatsen van DOM-, venster- en bepaalde extensie-API-aanroepen naar documenten buiten het scherm.
  • Update API-aanroepen —Sommige API-aanroepen moeten worden vervangen door modernere equivalenten.
  • Vervang blokkerende luisteraars voor webverzoeken: het blokkeren of wijzigen van netwerkverzoeken in Manifest V2 kan de prestaties aanzienlijk verslechteren en overmatige toegang tot gevoelige gebruikersgegevens vereisen. Met de Declarative Net Request API kunnen extensies webinhoud blokkeren of wijzigen met minder rechten en zonder de prestaties te belemmeren.
  • Verbeter de beveiliging van extensies —Manifest V3 verbetert de beveiliging van extensies op verschillende manieren. Naast een verbeterd inhoudbeveiligingsbeleid is de ondersteuning verwijderd voor op afstand gehoste code en de uitvoering van willekeurige tekenreeksen.
  • Publiceer uw extensie : in deze sectie wordt beschreven hoe u een stapsgewijze implementatie uitvoert om ervoor te zorgen dat uw Manifest V3-extensie naar verwachting werkt door deze eerst met een beperkt publiek te testen.

We hebben ook een Extension Manifest Converter . Het doet niet alles voor u, maar het helpt u wel op weg. De README van de converter beschrijft wat de tool verandert.

Behoud de huidige set functies

Om de kans op onverwachte problemen of bugs te verkleinen, raden we aan om tijdens het migreren geen nieuwe functionaliteit toe te voegen. Als u bijvoorbeeld een functie toevoegt waarvoor nieuwe machtigingen nodig zijn, kan er een toestemmingswaarschuwing worden geactiveerd , waardoor uw extensie wordt uitgeschakeld totdat de gebruiker de nieuwe machtigingen accepteert. Zie Best practices voor machtigingswaarschuwingen voor meer informatie over andere manieren om machtigingen toe te voegen zonder een waarschuwing weer te geven.

Manifest V3 wordt algemeen ondersteund in Chrome 88 of hoger. Bij het updaten van API-aanroepen kan het zijn dat vervangende functies pas na versie 88 in Chrome terechtkomen. De API-referentiepagina's bevatten ondersteuningsinformatie voor individuele API-leden. Als u ontdekt dat u een van deze functies nodig heeft, kunt u een minimale Chrome-versie opgeven in het manifestbestand.

Nieuwe uitbreidingsplatformfuncties

Sinds de release van Manifest V3 zijn we doorgegaan met het toevoegen van nieuwe functies , waarvan er vele bruikbaar zijn in zowel Manifest V2 als Manifest V3. U hoeft ze niet te gebruiken bij het converteren; Wanneer ze echter oudere functies vervangen, moet u deze verkiezen boven de functies die ze vervangen en verwachten dat de vervangen functies uiteindelijk verouderd en verwijderd zullen worden.