Zu Manifest V3 migrieren

Anleitung zum Umstellen von Manifest V2-Erweiterungen auf Manifest V3-Erweiterungen.

In diesem Abschnitt erfahren Sie, wie Sie eine Erweiterung von Manifest V2 auf Manifest V3, die neueste Version der Chrome-Erweiterungsplattform, umstellen. Die Migrationsarbeiten lassen sich grob in die folgenden Kategorien unterteilen. Damit Sie den Überblick behalten, haben wir eine Checkliste mit einer Zusammenfassung der Inhalte dieser Dokumente erstellt. Sie können über die Checkliste auf die Inhalte zugreifen oder direkt in die Inhalte eintauchen. Beide Pfade enden mit einer aktualisierten Erweiterung.

  • Manifest aktualisieren: Das manifest.json muss spezifisch für V3 sein. In diesem Abschnitt werden Änderungen beschrieben, die unabhängig vorgenommen werden können. Manifeständerungen im Zusammenhang mit Code werden mit den Codeänderungen beschrieben, die sie unterstützen.
  • Zu einem Service Worker migrieren: Ein Service Worker ersetzt die Hintergrund- oder Ereignisseite der Erweiterung, damit Hintergrundcode nicht im Hauptthread ausgeführt wird, wo er die Leistung beeinträchtigen kann. Für diese Änderung müssen auch DOM-, Fenster- und bestimmte Erweiterungs-API-Aufrufe in Offscreen-Dokumente verschoben werden.
  • API-Aufrufe aktualisieren: Einige API-Aufrufe müssen durch modernere Alternativen ersetzt werden.
  • Blockierende Webanfrage-Listener ersetzen: Das Blockieren oder Ändern von Netzwerkanfragen in Manifest V2 konnte die Leistung erheblich beeinträchtigen und übermäßigen Zugriff auf vertrauliche Nutzerdaten erfordern. Mit der Declarative Net Request API können Erweiterungen Webinhalte mit weniger Berechtigungen blockieren oder ändern, ohne die Leistung zu beeinträchtigen.
  • Sicherheit von Erweiterungen verbessern: Manifest V3 verbessert die Sicherheit von Erweiterungen auf verschiedene Weise. Neben einer verbesserten Content Security Policy wird die Unterstützung für extern gehosteten Code und die Ausführung beliebiger Strings entfernt.
  • Erweiterung veröffentlichen: In diesem Abschnitt wird beschrieben, wie Sie Ihre Manifest V3-Erweiterung stufenweise veröffentlichen, um sicherzustellen, dass sie wie erwartet funktioniert. Testen Sie sie dazu zuerst mit einer begrenzten Zielgruppe.

Außerdem gibt es einen Konverter für Erweiterungsmanifeste. Es erledigt nicht alles für Sie, aber es hilft Ihnen beim Einstieg. In der README-Datei des Konverters wird beschrieben, was das Tool ändert.

Aktuelle Funktionen beibehalten

Um das Risiko unerwarteter Probleme oder Fehler zu verringern, empfehlen wir, bei der Migration keine neuen Funktionen hinzuzufügen. Wenn Sie beispielsweise eine Funktion hinzufügen, für die neue Berechtigungen erforderlich sind, kann dies eine Berechtigungswarnung auslösen. Ihre Erweiterung wird dann deaktiviert, bis der Nutzer die neuen Berechtigungen akzeptiert. Unter Best Practices für Berechtigungswarnungen finden Sie weitere Möglichkeiten, Berechtigungen hinzuzufügen, ohne dass eine Warnung angezeigt wird.

Manifest V3 wird allgemein in Chrome 88 oder höher unterstützt. Beim Aktualisieren von API-Aufrufen stellen Sie möglicherweise fest, dass Ersatzfunktionen erst nach Version 88 in Chrome eingeführt wurden. Die API-Referenzseiten enthalten Supportinformationen für einzelne API-Mitglieder. Wenn Sie feststellen, dass Sie eine dieser Funktionen benötigen, können Sie in der Manifestdatei eine Mindestversion von Chrome angeben.

Neue Funktionen der Erweiterungsplattform

Seit der Veröffentlichung von Manifest V3 haben wir neue Funktionen hinzugefügt, von denen viele sowohl in Manifest V2 als auch in Manifest V3 verwendet werden können. Sie müssen sie bei der Umstellung nicht verwenden. Wenn sie jedoch ältere Funktionen ersetzen, sollten Sie sie den Funktionen vorziehen, die sie ersetzen. Es ist davon auszugehen, dass die ersetzten Funktionen schließlich eingestellt und entfernt werden.