Przeprowadź migrację do platformy Manifest V3

Przewodnik po konwersji rozszerzeń platformy Manifest V2 na rozszerzenia platformy Manifest V3.

Z tej sekcji dowiesz się, jak uaktualnić rozszerzenie z platformy Manifest V2 do najnowszej wersji platformy rozszerzeń do Chrome Manifest V3. Prace związane z migracją można ogólnie podzielić na poniższe kategorie. Aby ułatwić Ci śledzenie swojej pracy, przygotowaliśmy listę kontrolną podsumowującą zawartość tych dokumentów. Możesz uzyskać do nich dostęp dzięki liście kontrolnej lub zapoznać się z treścią. Obie ścieżki kończą się ulepszonym rozszerzeniem.

• Zaktualizuj plik manifestu – manifest.json musi być specyficzny dla wersji 3. W tej sekcji znajdziesz informacje o zmianach, które można wprowadzać samodzielnie. Zmiany w pliku manifestu związane z kodem są opisywane w ramach obsługiwanych przez nie zmian kodu.
• Migrate to a service worker (Migracja do mechanizmu Service Worker) – zastępuje on tło rozszerzenia lub stronę zdarzenia, aby mieć pewność, że kod tła nie znajduje się w wątku głównym, co może negatywnie wpływać na wydajność. Ta zmiana wymaga też przeniesienia DOM, okna i niektórych wywołań interfejsu API rozszerzeń do dokumentów poza ekranem.
• Aktualizowanie wywołań interfejsu API – niektóre wywołania interfejsu API należy zastąpić nowszymi odpowiednikami.
• Zastępowanie blokujących detektorów żądań sieciowych – blokowanie lub modyfikowanie żądań sieciowych za pomocą platformy Manifest V2 może znacznie obniżyć wydajność i wymagać nadmiernego dostępu do poufnych danych użytkownika. Deklaracja Net Request API umożliwia rozszerzeniom blokowanie lub modyfikowanie treści internetowych z mniejszymi uprawnieniami i bez obniżania wydajności.
• Zwiększ bezpieczeństwo rozszerzeń – Manifest V3 zwiększa bezpieczeństwo rozszerzeń na kilka sposobów. Oprócz zasady ulepszonego bezpieczeństwa treści wycofamy obsługę kodu hostowanego zdalnie i wykonania dowolnych ciągów tekstowych.
• Publikowanie rozszerzenia – w tej sekcji znajdziesz informacje, jak krokowo wdrożyć rozszerzenie na platformie Manifest V3, aby najpierw przetestować je na ograniczonej liczbie odbiorców, aby mieć pewność, że będzie ono działać zgodnie z oczekiwaniami.

Udostępniamy też narzędzie do konwertowania pliku manifestu rozszerzenia. Nie zrobi wszystkiego za Ciebie, ale pomoże Ci zacząć. Plik README konwertera opisuje, co zmienia się w narzędziu.

Zachowaj bieżący zestaw funkcji

Aby zmniejszyć ryzyko nieoczekiwanych problemów lub błędów, nie dodawaj nowych funkcji podczas migracji. Na przykład dodanie funkcji, która wymaga nowych uprawnień, może wywołać ostrzeżenie o uprawnieniach, co spowoduje wyłączenie rozszerzenia do czasu, aż użytkownik zaakceptuje nowe uprawnienia. Aby poznać inne sposoby dodawania uprawnień bez wyświetlania ostrzeżenia, zapoznaj się ze sprawdzonymi metodami dotyczącymi ostrzeżeń o uprawnieniach.

Platforma Manifest V3 jest ogólnie obsługiwana w Chrome 88 i nowszych wersjach. Podczas aktualizowania wywołań interfejsu API może się zdarzyć, że nowe funkcje będą dostępne w Chrome dopiero w wersji 88 i nowszej. Strony referencyjne interfejsu API zawierają informacje dotyczące pomocy poszczególnych użytkowników interfejsu API. Jeśli okaże się, że potrzebujesz jednej z tych funkcji, możesz określić minimalną wersję Chrome w pliku manifestu.

Nowe funkcje platformy rozszerzeń

Od momentu opublikowania platformy Manifest V3 dodaliśmy nowe funkcje, z których wiele jest przydatnych zarówno w platformie Manifest V2, jak i w platformie Manifest V3. Nie musisz ich używać przy konwersji, ale gdy zastąpią one starsze funkcje, lepiej wybrać te, które zastąpią, i spodziewać się, że zastąpione funkcje zostaną w końcu wycofane i usunięte.