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

Jak zmienić ikony, skróty, kolory i inne metadane w PWA

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

Po zainstalowaniu PWA przeglądarka używa informacji z pliku manifestu aplikacji internetowej dotyczących nazwy aplikacji, ikon, których powinna używać aplikacja, oraz adresu URL, który powinien zostać otwarty po uruchomieniu aplikacji. Co jednak, jeśli chcesz zaktualizować skróty aplikacji lub wypróbować nowy kolor motywu? Kiedy i w jaki sposób zmiany te są uwzględniane w przeglądarce?

W większości przypadków zmiany powinny być widoczne w ciągu 1–2 dni od uruchomienia aplikacji po zaktualizowaniu pliku manifestu.

Aktualizacje Chrome na komputerze

Gdy PWA jest uruchamiana lub otwierana na karcie przeglądarki, Chrome określa, kiedy ostatnio sprawdzono lokalny plik 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 (z wyjątkiem pola icons) są aktualizowane.

Które właściwości spowoduje uruchomienie aktualizacji?

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

Co się stanie, gdy zaktualizujesz pole 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 elementu 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.

Pliki referencyjne

Aktualizacje Chrome na Androida

Gdy uruchamiasz PWA, Chrome sprawdza, kiedy ostatnio sprawdzano lokalny plik manifestu pod kątem zmian. Jeśli manifest nie był sprawdzany w ciągu ostatnich 24 godzin, Chrome zaplanowa żądanie sieciowe dotyczące pliku manifestu, a potem porówna go z lokalną kopią.

Jeśli wybrane właściwości w pliku manifestu uległy zmianie (patrz lista poniżej), Chrome wstawia nowy plik manifestu do kolejki. Gdy wszystkie okna aplikacji PWA zostaną zamknięte, a urządzenie będzie podłączone do zasilania i połączone z siecią Wi-Fi, Chrome poprosi o aktualny plik WebAPK ze serwera. Po zaktualizowaniu wszystkie pola z nowego pliku manifestu są używane.

Które usługi spowodują aktualizację?

  • name
  • short_name
  • icons
  • 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

Na stronie about://webapks znajdziesz szczegółowe informacje o wszystkich Progressive Web Apps zainstalowanych na urządzeniu. Możesz się na niej dowiedzieć, kiedy manifest został ostatnio zaktualizowany, jak często jest aktualizowany itp.

Aby ręcznie zaplanować aktualizację pliku manifestu, zastępując timer i manifest lokalny, wykonaj te czynności:

  1. Podłącz urządzenie do zasilania i upewnij się, że jest połączone z Wi-Fi.
  2. Użyj menedżera zadań Androida, aby zamknąć PWA, a potem użyj panelu aplikacji w ustawieniach Androida, aby wymusić zatrzymanie PWA.
  3. W Chrome otwórz about://webapks i kliknij przycisk „Aktualizuj” obok PWA. Wartość „Update Status” (Zaktualizuj stan) powinna zmienić się na „Pending” (Oczekuje).
  4. Uruchom PWA i sprawdź, czy została poprawnie wczytana.
  5. Wyłącz PWA w menedżerze zadań Androida, a potem w panelu aplikacji w ustawieniach Androida wymuś jego zatrzymanie.

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

Pliki referencyjne