Śledzenie postępów migracji
Poniższe listy kontrolne pomogą Ci śledzić postępy migracji. Określają one zadania, które należy wykonać, i zawierają linki do instrukcji. Prace związane z migracją dzielą się na 5 kategorii, które opisano w podsumowaniu migracji.
Aktualizowanie pliku manifestu
Plik manifest.json wymaga nieco innego formatu w przypadku Manifestu V3 niż w przypadku Manifestu V2. Na tej stronie opisujemy zmiany, które dotyczą tylko pliku manifest.json. Wiele zmian w skryptach i stronach wymaga też zmian w pliku manifestu. Te zmiany są uwzględnione w zadaniach migracji, które ich wymagają.
- Zmień numer wersji pliku manifestu.
- Zaktualizuj uprawnienia hosta.
- Aktualizowanie zasobów dostępnych w internecie
Migracja do skryptu 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. Dzięki temu rozszerzenia działają tylko wtedy, gdy są potrzebne, co pozwala oszczędzać zasoby.
Zanim zaczniesz, przeczytaj o różnicach między skryptami działającymi w tle a procesami roboczymi usługi rozszerzenia.
- Zaktualizuj pole „background” w pliku manifestu
- Przenoszenie wywołań DOM i okien do dokumentu poza ekranem
- Konwertowanie localStorage na chrome.storage.local
- Synchroniczne rejestrowanie detektorów zdarzeń
- Zastąp wywołania
XMLHttpRequest()globalnymfetch(). - Utrwalanie stanów
- Przekształcanie minutników w alarmy
- Utrzymanie działania skryptu service worker (w wyjątkowych przypadkach)
Aktualizowanie wywołań interfejsu API
Niektóre funkcje należy zastąpić odpowiednikami z Manifestu V3. Inne należy całkowicie usunąć.
- Zastąp
tabs.executeScript()tekstemscripting.executeScript(). - Zastąp
tabs.insertCSS()itabs.removeCSS()wartościamiscripting.insertCSS()iscripting.removeCSS(). - Zastępowanie czynności w przeglądarce i czynności na stronie czynnościami
- Zastąp funkcje, które oczekują kontekstu tła platformy Manifest V2.
- Zastępowanie wywołań zwrotnych obietnicami
- Zastąpienie nieobsługiwanych interfejsów API
Zastępowanie odbiorników blokujących żądania sieciowe
Zamiast programowo odczytywać żądania sieciowe i je zmieniać (jak w przypadku Manifestu V2), rozszerzenie określa reguły opisujące działania, które mają być wykonywane po spełnieniu określonego zestawu warunków.
Po wykonaniu powyższych czynności możesz zapoznać się z kilkoma typami zastosowań:
Zwiększanie bezpieczeństwa rozszerzeń
Wymagane są zmiany, aby zwiększyć bezpieczeństwo rozszerzeń. Obejmuje to usuwanie kodu hostowanego zdalnie, który nie jest już obsługiwany.
- Usuwanie wykonywania dowolnych ciągów znaków
- Usuwanie kodu hostowanego zdalnie
- Zaktualizuj zasady bezpieczeństwa treści.
- Usuwanie nieobsługiwanych wartości zasad bezpieczeństwa treści
Publikowanie rozszerzenia Manifest V3
Po przekonwertowaniu rozszerzenia na platformę Manifest V3 możesz opublikować je w Chrome Web Store. W zależności od wprowadzonych zmian rozważ stopniowe wdrażanie. Dzięki temu możesz najpierw sprawdzić, czy rozszerzenie działa zgodnie z oczekiwaniami w przypadku ograniczonej grupy odbiorców, zanim udostępnisz je wszystkim użytkownikom.