Zu Manifest V3 migrieren

Ein Leitfaden zur Umwandlung von Manifest V2-Erweiterungen in Manifest V3-Erweiterungen

In diesem Abschnitt erfahren Sie, wie Sie eine Erweiterung von Manifest V2 auf Manifest V3 aktualisieren, die neueste Version der Plattform für Chrome-Erweiterungen. Die Migration ist grob in die folgenden Kategorien unterteilt. Damit Sie Ihre Arbeit leichter nachverfolgen können, stellen wir Ihnen eine Checkliste mit einer Zusammenfassung des Inhalts dieser Dokumente zur Verfügung. Du kannst über die Checkliste auf die Inhalte zugreifen oder sie genauer ansehen. Beide Pfade enden mit einer aktualisierten Erweiterung.

  • Manifest aktualisieren: Der manifest.json muss für V3 spezifisch sein. In diesem Abschnitt werden Änderungen beschrieben, die Sie selbst vornehmen können. Manifeständerungen im Zusammenhang mit Code werden mit den unterstützten Codeänderungen beschrieben.
  • Migration zu einem Service Worker: Ein Service Worker ersetzt den Hintergrund oder die Ereignisseite der Erweiterung, damit Hintergrundcode außerhalb des Hauptthreads bleibt und die Leistung beeinträchtigt werden kann. Diese Änderung erfordert außerdem das Verschieben von DOM-, Fenster- und bestimmten Erweiterungs-API-Aufrufen in Dokumente außerhalb des Bildschirms.
  • API-Aufrufe aktualisieren: Einige API-Aufrufe müssen durch modernere Äquivalente ersetzt werden.
  • Blockieren von Webanfrage-Listenern ersetzen: Das Blockieren oder Ändern von Netzwerkanfragen in Manifest V2 könnte 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 und ohne Beeinträchtigung der Leistung blockieren oder ändern.
  • Sicherheit von Erweiterungen verbessern: Manifest V3 verbessert die Sicherheit von Erweiterungen in mehrfacher Hinsicht. Abgesehen von der erweiterten Content Security Policy wird die Unterstützung für remote gehosteten Code und die Ausführung beliebiger Strings entfernt.
  • Erweiterung veröffentlichen: In diesem Abschnitt wird beschrieben, wie Sie schrittweise einführen, um sicherzustellen, dass Ihre Manifest V3-Erweiterung wie erwartet funktioniert. Dazu sollten Sie sie zuerst mit einer eingeschränkten Zielgruppe testen.

Wir haben auch einen Extension Manifest Converter. Es erledigt nicht alles für Sie, hilft Ihnen aber bei den ersten Schritten. In der Readme-Datei des Converters werden die Änderungen beschrieben, die im Tool vorgenommen werden.

Aktuellen Funktionsumfang beibehalten

Wir empfehlen, bei der Migration keine neuen Funktionen hinzuzufügen, um die Wahrscheinlichkeit von unerwarteten Problemen oder Fehlern zu verringern. Wenn Sie beispielsweise eine Funktion hinzufügen, für die neue Berechtigungen erforderlich sind, kann eine Berechtigungswarnung ausgelöst werden. In diesem Fall wird Ihre Erweiterung deaktiviert, bis der Nutzer die neuen Berechtigungen akzeptiert. Unter Best Practices für Berechtigungswarnungen finden Sie weitere Möglichkeiten, Berechtigungen ohne Warnung hinzuzufügen.

Manifest V3 wird generell in Chrome 88 oder höher unterstützt. Beim Aktualisieren von API-Aufrufen stellen Sie möglicherweise fest, dass Ersatzfunktionen möglicherweise erst nach Version 88 in Chrome verfügbar sind. Die API-Referenzseiten enthalten Supportinformationen zu den einzelnen API-Mitgliedern. Wenn 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 weitere Funktionen hinzugefügt, von denen viele sowohl in Manifest V2 als auch in Manifest V3 verwendbar sind. Sie müssen sie bei der Konvertierung nicht verwenden. Wenn sie jedoch ältere Funktionen ersetzen, sollten Sie sie den Funktionen vorziehen, die sie ersetzen, und davon ausgehen, dass die ersetzten Funktionen irgendwann eingestellt und entfernt werden.