Śledzenie postępu migracji
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()globalnymfetch(). - 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()nascripting.executeScript(). - Zamień
tabs.insertCSS()itabs.removeCSS()nascripting.insertCSS()iscripting.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.
Po wykonaniu czynności wymienionych powyżej możesz zapoznać się z kilkoma typowymi przypadkami użycia:
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.