Obsługa aktualizacji w manifeście aplikacji internetowej w Chrome

Informacje o zmianie ikon, skrótów, kolorów i innych metadanych PWA

Adriana Jara
François Beaufort
François Beaufort
GitHub
Pete LePage

Po zainstalowaniu PWA przeglądarka korzysta z informacji z manifestu aplikacji internetowej jako nazwy aplikacji, ikon, których powinna używać, oraz adresu URL, który powinien być otwierany po uruchomieniu aplikacji. A co, jeśli musisz zaktualizować skróty do aplikacji lub wypróbować nowy kolor motywu? Kiedy i w jaki sposób te zmiany są odzwierciedlane w przeglądarce?

W większości przypadków zmiany powinny zostać uwzględnione w ciągu 1–2 dni od opublikowania aplikacji PWA, po zaktualizowaniu pliku manifestu.

Aktualizacje Chrome na komputerze

Po uruchomieniu aplikacji PWA lub otwarciu jej w karcie przeglądarki Chrome określa czas ostatniego sprawdzenia lokalnego pliku manifestu pod kątem zmian. Jeśli plik manifestu nie został sprawdzony od ostatniego uruchomienia przeglądarki lub w ciągu ostatnich 24 godzin, Chrome wysyła żądanie sieciowe na ten plik, a następnie porównuje go z kopią lokalną.

Jeśli wybrane właściwości w pliku manifestu uległy zmianie (zobacz listę poniżej), Chrome umieści nowy plik manifestu w kolejce, a po zamknięciu wszystkich okien zainstaluje go. Po zainstalowaniu wszystkie pola z nowego pliku manifestu (oprócz name, short_name i icons) zostaną zaktualizowane.

Które usługi spowodują aktualizację?

  • display (patrz poniżej)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

Co się dzieje po zaktualizowaniu pola display?

Jeśli zmienisz tryb wyświetlania aplikacji z browser na standalone, po aktualizacji dotychczasowi użytkownicy nie będą mieli otwierania aplikacji w oknie. W przypadku aplikacji internetowej dostępne są 2 ustawienia wyświetlania: jedno z kontrolowanego przez Ciebie manifestu i ustawienie karty okna/przeglądarki kontrolowane przez użytkownika. Preferencje użytkownika są zawsze respektowane.

Testowanie aktualizacji pliku manifestu

Strona chrome://web-app-internals (dostępna w Chrome w wersji 85 i nowszych) zawiera szczegółowe informacje o wszystkich aplikacjach PWA zainstalowanych na urządzeniu. Dzięki niej dowiesz się m.in., kiedy plik manifestu został ostatnio zaktualizowany, jak często jest aktualizowany.

Aby ręcznie wymusić w Chrome sprawdzenie dostępności zaktualizowanego pliku manifestu, możesz uruchomić Chrome przy użyciu flagi wiersza poleceń --disable-manifest-update-throttle lub ponownie uruchomić Chrome (przy użyciu polecenia about://restart). Spowoduje to zresetowanie licznika czasu, dzięki czemu podczas następnego uruchomienia aplikacji PWA Chrome będzie sprawdzać dostępność zaktualizowanego pliku manifestu. Następnie uruchom PWA. Po zamknięciu aplikacji PWA powinna zostać zaktualizowana o nowe właściwości pliku manifestu.

Źródła

Aktualizacje Chrome na Androida

Po uruchomieniu PWA Chrome określa czas ostatniego sprawdzenia lokalnego pliku manifestu pod kątem zmian. Jeśli plik manifestu nie został sprawdzony w ciągu ostatnich 24 godzin, Chrome zaplanuje żądanie sieciowe dla tego pliku, a następnie porówna go z kopią lokalną.

Jeśli wybrane właściwości w pliku manifestu uległy zmianie (zobacz listę poniżej), Chrome umieści nowy plik manifestu w kolejce, a po zamknięciu wszystkich okien PWA urządzenie jest podłączone i połączone z Wi-Fi, Chrome wysyła do serwera żądanie zaktualizowanego pakietu WebAPK. Po zaktualizowaniu wszystkie pola z nowego pliku manifestu są używane.

Które usługi spowodują aktualizację?

  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Jeśli Chrome nie może pobrać zaktualizowanego pliku manifestu z serwera, może to wydłużyć czas sprawdzania do 30 dni.

Testowanie aktualizacji pliku manifestu

Strona about://webapks zawiera szczegółowe informacje o wszystkich aplikacjach PWA zainstalowanych na urządzeniu, a także o tym, kiedy plik manifestu został ostatnio zaktualizowany, jak często jest aktualizowany itd.

Aby ręcznie zaplanować aktualizację pliku manifestu, zastąp licznik czasu i lokalny plik manifestu w ten sposób:

  1. Podłącz urządzenie do zasilania i upewnij się, że jest połączone z Wi-Fi.
  2. Wyłącz PWA w menedżerze zadań Androida, a potem w panelu aplikacji w ustawieniach Androida wymusić jego zatrzymanie.
  3. W Chrome otwórz about://webapks i kliknij przycisk „Aktualizuj” obok PWA. „Stan aktualizacji” powinien się zmienić na „Oczekująca”.
  4. Uruchom PWA i sprawdź, czy została prawidłowo wczytana.
  5. Wyłącz PWA w menedżerze zadań Androida, a potem w panelu aplikacji w ustawieniach Androida wymusić jego zatrzymanie.

PWA zwykle aktualizuje się w ciągu kilku minut. Po zakończeniu aktualizacji komunikat „Stan aktualizacji” powinien zmienić się na „Powodzenie”.

Źródła