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 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 w Chrome na komputery

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 manifest nie został sprawdzony od ostatniego uruchomienia przeglądarki lub nie został sprawdzony w ciągu ostatnich 24 godzin, Chrome wyśle żą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 i po zamknięciu wszystkich okien instaluje 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 zaktualizujesz tryb wyświetlania aplikacji z browser na standalone, po aktualizacji aplikacje obecnych użytkowników nie będą się otwierać w oknie. Aplikacja internetowa ma 2 ustawienia wyświetlania: jedno z pliku manifestu (które kontrolujesz) 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 85 lub nowszej wersji) zawiera szczegółowe informacje o wszystkich Progressive Web Apps zainstalowanych na urządzeniu. Możesz na niej sprawdzić, kiedy ostatnio zaktualizowano plik manifestu, jak często jest aktualizowany itp.

Aby ręcznie wymusić sprawdzenie przez Chrome zaktualizowanego pliku manifestu, możesz uruchomić Chrome z flagą wiersza polecenia --disable-manifest-update-throttle lub ponownie uruchomić Chrome (użyj about://restart). Spowoduje to zresetowanie minutnika, dzięki czemu Chrome sprawdzi zaktualizowany plik manifestu, gdy następnym razem uruchomisz PWA. Następnie uruchom PWA. Po zamknięciu PWA należy go zaktualizować, dodając nowe właściwości pliku manifestu.

Odniesienia

Aktualizacje w 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 właściwości spowoduje uruchomienie aktualizacji?

  • 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 wydłużyć czas między sprawdzaniem 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ąpić timer i manifest lokalny, wykonaj jedną z tych czynności:

  1. Podłącz urządzenie 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. Stan „Update Status” (Zaktualizuj stan) powinien zmienić się na „Pending” (Oczekuje).
  4. Uruchom PWA i sprawdź, czy wczytuje się prawidłowo.
  5. Użyj menedżera zadań Androida, aby zamknąć PWA, a potem użyj panelu aplikacji w ustawieniach Androida, aby wymusić zatrzymanie PWA.

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

Odniesienia