Checkliste für die Migration zu Manifest V3

Migrationsfortschritt im Blick behalten

Die folgenden Checklisten helfen Ihnen, den Fortschritt Ihrer Migration im Blick zu behalten. Sie definieren Aufgaben, die erledigt werden müssen, und enthalten Links zu Anleitungen. Die Migrationsarbeit wird grob in fünf Kategorien unterteilt, wie in der Migrationszusammenfassung beschrieben.

Manifest aktualisieren

Die Datei manifest.json erfordert für Manifest V3 ein etwas anderes Format als für Manifest V2. Auf dieser Seite werden Änderungen beschrieben, die sich nur auf die Datei manifest.json auswirken. Viele Änderungen an Scripts und Seiten erfordern jedoch auch Änderungen am Manifest. Diese Änderungen werden in den Migrationsaufgaben behandelt, für die sie erforderlich sind.

• Manifest-Versionsnummer ändern
• Hostberechtigungen aktualisieren
• Webzugängliche Ressourcen aktualisieren:

Zu einem Service Worker migrieren

Ein Service Worker ersetzt die Hintergrund- oder Ereignisseite der Erweiterung, damit der Hintergrundcode nicht im Hauptthread ausgeführt wird. So können Erweiterungen nur bei Bedarf ausgeführt werden, was Ressourcen spart.

Bevor Sie beginnen, sollten Sie sich über die Unterschiede zwischen Hintergrundskripts und Service Workern für Erweiterungen informieren.

• Feld „background“ im Manifest aktualisieren
• DOM- und Fensteraufrufe in ein Offscreen-Dokument verschieben
• localStorage in chrome.storage.local konvertieren
• Listener synchron registrieren
• Ersetzen Sie Aufrufe von XMLHttpRequest() durch globale fetch().
• Status beibehalten
• Timer in Wecker umwandeln
• Service Worker in Ausnahmefällen aktiv halten

API-Aufrufe aktualisieren

Einige Funktionen müssen durch Manifest V3-Entsprechungen ersetzt werden. Andere müssen vollständig entfernt werden.

• Ersetzen Sie tabs.executeScript() durch scripting.executeScript().
• Ersetzen Sie tabs.insertCSS() und tabs.removeCSS() durch scripting.insertCSS() und scripting.removeCSS().
• Browser- und Seitenaktionen durch Aktionen ersetzen
• Funktionen ersetzen, die einen Hintergrundkontext für Manifest V2 erwarten:
• Callbacks durch Promises ersetzen
• Nicht unterstützte APIs ersetzen

Listener für blockierende Webanfragen ersetzen

Anstatt Netzwerkanfragen programmatisch zu lesen und zu ändern (wie in Manifest V2), gibt Ihre Erweiterung Regeln an, die beschreiben, welche Aktionen ausgeführt werden sollen, wenn eine bestimmte Reihe von Bedingungen erfüllt ist.

• Berechtigungen aktualisieren
• Regeln für deklarative Netzwerkanfragen erstellen

Nachdem Sie die oben genannten Schritte ausgeführt haben, können Sie sich einige häufige Anwendungsfälle ansehen:

• Einzelne URL blockieren
• Redirect-multiple-urls
• Cookies blockieren

Sicherheit von Erweiterungen verbessern

Änderungen sind erforderlich, um die Sicherheit von Erweiterungen zu verbessern. Dazu gehört auch das Entfernen von Remote-gehostetem Code, der nicht mehr unterstützt wird.

• Ausführung beliebiger Strings entfernen:
• Remote gehosteten Code entfernen
• Content Security Policy aktualisieren
• Nicht unterstützte Werte für die Content Security Policy entfernen

Manifest V3-Erweiterung veröffentlichen

Nach der Umstellung auf Manifest V3 können Sie Ihre Erweiterung im Chrome Web Store veröffentlichen. Je nach den vorgenommenen Änderungen sollten Sie einen stufenweisen Roll-out in Betracht ziehen. So können Sie zuerst mit einer begrenzten Zielgruppe testen, ob Ihre Erweiterung wie erwartet funktioniert, bevor Sie sie für alle Nutzer freigeben.

• Betaversion veröffentlichen
• Release schrittweise einführen:
• Überprüfungszeiten einplanen:
• Zusätzliche Tipps