Przeprowadź migrację do platformy Manifest V3

Przewodnik po przekształcaniu rozszerzeń platformy Manifest V2 w rozszerzenia platformy Manifest V3.

W tej sekcji znajdziesz informacje o tym, jak zaktualizować rozszerzenie z platformy Manifest V2 do Manifest V3, czyli najnowszej wersji platformy rozszerzeń do Chrome. Prace związane z migracją dzielą się na te kategorie: Aby ułatwić Ci śledzenie postępów, przygotowaliśmy listę kontrolną podsumowującą zawartość tych dokumentów. Możesz uzyskać dostęp do treści za pomocą listy kontrolnej lub przejść bezpośrednio do treści. Obie ścieżki kończą się uaktualnionym rozszerzeniem.

• Zaktualizuj plik manifestu – manifest.json musi być specyficzny dla wersji 3. Zmiany, które można wprowadzić samodzielnie, opisujemy w tej sekcji. Zmiany w pliku manifestu związane z kodem są opisywane wraz ze zmianami kodu, które obsługują.
• Przejdź na skrypt service worker – skrypt service worker zastępuje stronę tła lub stronę zdarzeń rozszerzenia, aby kod działający w tle nie był wykonywany w głównym wątku, co mogłoby negatywnie wpłynąć na wydajność. Ta zmiana wymaga też przeniesienia wywołań interfejsu DOM, okna i niektórych interfejsów API rozszerzeń do dokumentów poza ekranem.
• Aktualizowanie wywołań interfejsu API – niektóre wywołania interfejsu API należy zastąpić nowocześniejszymi odpowiednikami.
• Zastąpienie blokujących odbiorników żądań internetowych – blokowanie lub modyfikowanie żądań sieciowych w przypadku platformy Manifest V2 może znacznie pogorszyć wydajność i wymagać nadmiernego dostępu do wrażliwych danych użytkownika. Interfejs Declarative Net Request API umożliwia rozszerzeniom blokowanie lub modyfikowanie treści internetowych przy użyciu mniejszej liczby uprawnień i bez pogarszania wydajności.
• Zwiększenie bezpieczeństwa rozszerzenia – platforma Manifest V3 zwiększa bezpieczeństwo rozszerzenia na kilka sposobów. Oprócz ulepszonej zasady bezpieczeństwa treści usunięto obsługę kodu hostowanego zdalnie i wykonywania dowolnych ciągów znaków.
• Publikowanie rozszerzenia – w tej sekcji dowiesz się, jak publikować rozszerzenie Manifest V3 etapami, aby mieć pewność, że działa ono zgodnie z oczekiwaniami. W tym celu najpierw przetestuj je na ograniczonej grupie odbiorców.

Mamy też konwerter plików manifestu rozszerzenia. Nie zrobi wszystkiego za Ciebie, ale pomoże Ci zacząć. Plik README konwertera zawiera opis zmian wprowadzanych przez to narzędzie.

Zachowaj bieżący zestaw funkcji

Aby zmniejszyć ryzyko wystąpienia nieoczekiwanych problemów lub błędów, podczas migracji nie zalecamy dodawania nowych funkcji. Na przykład dodanie funkcji, która wymaga nowych uprawnień, może wywołać ostrzeżenie o uprawnieniach, co spowoduje wyłączenie rozszerzenia, dopóki użytkownik nie zaakceptuje nowych uprawnień. Więcej informacji o innych sposobach dodawania uprawnień bez wyświetlania ostrzeżenia znajdziesz w artykule Sprawdzone metody dotyczące 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żesz zauważyć, że funkcje zastępcze mogą nie być dostępne w Chrome aż do wersji 88. Strony dokumentacji API zawierają informacje o pomocy dotyczące poszczególnych elementów interfejsu API. Jeśli okaże się, że potrzebujesz którejś z tych funkcji, możesz określić minimalną wersję Chrome w pliku manifestu.

Nowe funkcje platformy rozszerzeń

Od czasu wprowadzenia platformy Manifest V3 stale dodajemy nowe funkcje, z których wiele można używać zarówno na platformie Manifest V2, jak i Manifest V3. Nie musisz ich używać podczas konwersji, ale gdy zastępują starsze funkcje, powinieneś(-aś) preferować je od tych funkcji i oczekiwać, że zastąpione funkcje zostaną ostatecznie wycofane i usunięte.