Den Fortschritt der Migration im Blick behalten
Die folgenden Checklisten sollen Ihnen dabei helfen, den Überblick über Ihre Migrationsarbeiten zu behalten. Sie definieren Aufgaben, die erledigt werden müssen, mit Links zu Anweisungen. Die Migrationsarbeit ist grob in fünf Kategorien unterteilt, wie in der Migrationsübersicht beschrieben.
Manifest aktualisieren
Die Datei manifest.json verlangt bei Manifest V3 ein etwas anderes Format als bei Manifest V2. Auf dieser Seite werden Änderungen beschrieben, die nur die Datei manifest.json betreffen. Viele der Änderungen an Skripts und Seiten erfordern jedoch auch Änderungen am Manifest. Diese Änderungen werden durch die Migrationsaufgaben abgedeckt, für die sie erforderlich sind.
- Versionsnummer des Manifests ändern
- Hostberechtigungen aktualisieren
- Über das Web zugängliche Ressourcen aktualisieren
Zu einem Service Worker migrieren
Ein Service Worker ersetzt die Hintergrund- oder Ereignisseite der Erweiterung, um dafür zu sorgen, dass Hintergrundcode nicht im Hauptthread angezeigt wird. Dadurch können Erweiterungen nur bei Bedarf ausgeführt werden, was Ressourcen spart.
Lesen Sie sich zunächst die Unterschiede zwischen Hintergrundskripts und Erweiterungsdienst-Workern durch.
- Das Feld „Hintergrund“ im Manifest aktualisieren
- DOM- und Fensteraufrufe in Dokumente außerhalb des Bildschirms verschieben
- „localStorage“ in „chrome.storage.local“ konvertieren
- Listener synchron registrieren
- Aufrufe von
XMLHttpRequest()durch globalenfetch()ersetzen. - Status beibehalten
- Timer in Wecker umwandeln
- Service Worker am Leben halten (in Ausnahmefällen)
API-Aufrufe aktualisieren
Einige Funktionen müssen durch Manifest V3-Entsprechungen ersetzt werden. Andere müssen vollständig entfernt werden.
- Ersetzen Sie
tabs.executeScript()durchscripting.executeScript(). - Ersetzen Sie
tabs.insertCSS()undtabs.removeCSS()durchscripting.insertCSS()undscripting.removeCSS(). - Browseraktionen und Seitenaktionen durch Aktionen ersetzen
- Funktionen ersetzen, die einen Manifest V2-Hintergrundkontext erwarten
- Callbacks durch Promis 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 Aktionen beschreiben, die ausgeführt werden sollen, wenn eine bestimmte Gruppe von Bedingungen erfüllt ist.
Nachdem Sie die oben genannten Schritte abgeschlossen haben, sollten Sie sich einige häufige Anwendungsfälle ansehen:
Sicherheit von Erweiterungen verbessern
Zur Verbesserung der Sicherheit von Erweiterungen sind Änderungen erforderlich. Dazu gehört auch das Entfernen von extern 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 Content Security Policy entfernen
Manifest V3-Erweiterung veröffentlichen
Nachdem du deine Erweiterung auf Manifestversion 3 umgestellt hast, kannst du sie im Chrome Web Store veröffentlichen. Erwägen Sie je nach den vorgenommenen Änderungen eine schrittweise Einführung. So können Sie dafür sorgen, dass Ihre Erweiterung zuerst für eine begrenzte Zielgruppe wie erwartet funktioniert, bevor Sie sie für die gesamte Nutzerbasis freigeben.