Lista kontrolna migracji platformy Manifest V3

Śledzenie postępu migracji

Uwaga: platforma Manifest V3 jest obsługiwana zasadniczo w Chrome 88 i nowszych wersjach. Informacje o funkcjach rozszerzeń dodanych w późniejszych wersjach Chrome znajdziesz w dokumentacji referencyjnej interfejsu API. Jeśli rozszerzenie wymaga określonego interfejsu API, w pliku manifestu możesz określić minimalną wersję Chrome.

Poniższe listy kontrolne pomogą Ci prześledzić działania migracji. Określają one zadania, które należy wykonać, za pomocą linków do instrukcji. Proces migracji dzieli się ogólnie na 5 kategorii, zgodnie z opisem w podsumowaniu migracji.

Zaktualizuj plik manifestu

W przypadku platformy Manifest V3 plik manifest.json wymaga nieco innego formatu niż w przypadku platformy Manifest V2. Na tej stronie opisujemy zmiany, które dotyczą tylko pliku manifest.json. Wiele zmian w skryptach i stronach wymaga jednak wprowadzenia zmian w pliku manifestu. Te zmiany są związane z zadaniami migracji, które ich wymagają.

• Zmień numer wersji pliku manifestu.
• Aktualizowanie uprawnień gospodarza
• Zaktualizuj zasoby dostępne w internecie.

Migracja do skryptu service worker

Skrypt service worker zastępuje tło lub stronę zdarzenia rozszerzenia, by upewnić się, że kod tła nie jest widoczny w wątku głównym. Dzięki temu rozszerzenia mogą być uruchamiane tylko wtedy, gdy jest to potrzebne, co oszczędza zasoby.

Zanim zaczniesz, przeczytaj o różnicach między skryptami działającymi w tle a skryptami service worker rozszerzeń.

• Aktualizowanie pola „tło” w pliku manifestu
• Przenoszenie wywołań DOM i okien do dokumentu poza ekranem
• Przekształcanie pliku localStorage na chrome.storage.local
• Synchronicznie rejestrowanie detektorów
• Zastąp wywołania XMLHttpRequest() globalnym fetch().
• Utrwalanie stanów
• Konwertuj minutniki na alarmy
• Utrzymywanie aktywności skryptu service worker (w wyjątkowych przypadkach)

Aktualizowanie wywołań interfejsu API

Niektóre funkcje należy zastąpić odpowiednikami platformy Manifest V3. Inne należy całkowicie usunąć.

• Zamień tabs.executeScript() na scripting.executeScript().
• Zamień tabs.insertCSS() i tabs.removeCSS() na scripting.insertCSS() i scripting.removeCSS().
• Zastępowanie działań przeglądarki i działań na stronie działaniami na stronie
• Zastąp funkcje, które oczekują kontekstu w tle platformy Manifest V2.
• Zastępowanie wywołań zwrotnych obietnicami
• Zastępowanie nieobsługiwanych interfejsów API

Zastąp blokowanie detektorów żądań internetowych

Zamiast programowo odczytywać żądania sieciowe i zmieniać je (tak jak w pliku manifestu w wersji 2), rozszerzenie określa reguły opisujące działania, które mają zostać wykonane po spełnieniu określonego zestawu warunków.

• Zaktualizuj uprawnienia
• Tworzenie deklaratywnych reguł żądań netto

Po wykonaniu czynności wymienionych powyżej możesz zapoznać się z kilkoma typowymi przypadkami użycia:

• Blokowanie pojedynczego adresu URL
• Przekierowanie do wielu adresów URL
• Blokowanie plików cookie

Zwiększanie bezpieczeństwa rozszerzeń

Wymagane są zmiany w celu zwiększenia bezpieczeństwa rozszerzeń. Obejmuje to usunięcie kodu hostowanego zdalnie, który nie jest już obsługiwany.

• Usuń wykonanie dowolnych ciągów tekstowych.
• Usuwanie kodu hostowanego zdalnie
• Aktualizowanie polityki bezpieczeństwa treści
• Usuwanie nieobsługiwanych wartości zasad bezpieczeństwa treści

Opublikuj rozszerzenie Manifest V3

Po przekonwertowaniu pliku manifestu na wersję 3 możesz opublikować rozszerzenie w Chrome Web Store. W zależności od wprowadzonych zmian rozważ wdrożenie stopniowe. Dzięki temu będziesz mieć pewność, że rozszerzenie będzie działać zgodnie z oczekiwaniami przy ograniczonej liczbie odbiorców, zanim udostępnimy je wszystkim użytkownikom.

• Opublikować wersję beta.
• Wdrażanie wersji stopniowo.
• Uwzględnij czas weryfikacji.
• Dodatkowe wskazówki.