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

Gdy jest zainstalowana PWA, przeglądarka używa informacji z aplikacji internetowej plik manifestu z nazwą aplikacji, ikonami, których powinna używać aplikacja, oraz adresem URL powinna być otwarta podczas uruchamiania aplikacji. Ale co, jeśli konieczna jest aktualizacja skróty do aplikacji lub wypróbuj nowy kolor motywu? Kiedy i jak te zmiany co widać w przeglądarce?

W większości przypadków zmiany powinny zostać wprowadzone w ciągu 1-2 dni Uruchamianie PWA po zaktualizowaniu pliku manifestu.

Aktualizacje Chrome na komputerze

Po uruchomieniu aplikacji PWA lub otwarciu jej na karcie przeglądarki Chrome określa podczas ostatniego sprawdzania lokalnego pliku manifestu pod kątem zmian. Jeśli w pliku manifestu nie ma została sprawdzona od ostatniego uruchomienia przeglądarki lub nie została sprawdzona w w ciągu ostatnich 24 godzin Chrome wyśle żądanie sieciowe dotyczące pliku manifestu, a następnie porównując go z wersją lokalną.

Jeśli wybrane właściwości w pliku manifestu uległy zmianie (zobacz listę poniżej), Chrome dodaje nowy plik manifestu do kolejki, a po zamknięciu wszystkich okien instaluje go. Po zainstalowaniu wszystkie pola z nowego pliku manifestu (oprócz name, short_name, i icons) zostały 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 zaktualizujesz tryb wyświetlania aplikacji z browser na standalone, Istniejący użytkownicy nie będą mieli otwieranych aplikacji w oknie po aktualizacji. OK dla aplikacji internetowej są dwa ustawienia wyświetlania. Ustawienia z pliku manifestu ) oraz ustawieniem karty okna/przeglądarki kontrolowane przez użytkownika. Użytkownik ustawienia są zawsze respektowane.

Testowanie aktualizacji pliku manifestu

stronę chrome://web-app-internals (dostępna w Chrome 85 i nowszych wersjach), zawiera szczegółowe informacje o wszystkich aplikacjach PWA zainstalowanych na urządzeniu; i może pomóc Ci zrozumieć, kiedy plik manifestu był ostatnio aktualizowany i jak często i inne zmiany.

Aby ręcznie wymusić w Chrome sprawdzenie dostępności zaktualizowanego pliku manifestu, możesz uruchomić Chrome z flagą wiersza poleceń --disable-manifest-update-throttle lub uruchom ponownie Chrome (użyj about://restart). Spowoduje to zresetowanie licznika i przywrócenie Chrome sprawdzi zaktualizowany plik manifestu podczas następnego uruchomienia aplikacji PWA. Następnie uruchom czyli progresywnych aplikacji internetowych. Po zamknięciu PWA powinna zostać zaktualizowana za pomocą nowego pliku manifestu. usług.

Pliki referencyjne

Aktualizacje Chrome na Androida

Po uruchomieniu aplikacji PWA Chrome określa czas ostatniego użycia lokalnego pliku manifestu została sprawdzona pod kątem zmian. Jeśli plik manifestu nie był sprawdzany w ciągu ostatnich 24 dni godzin, Chrome zaplanuje żądanie sieciowe dla pliku manifestu i porówna w porównaniu z wersją lokalną.

Jeśli wybrane właściwości w pliku manifestu uległy zmianie (zobacz listę poniżej), Chrome dodaje nowy plik manifestu do kolejki, a po zamknięciu wszystkich okien PWA jeśli urządzenie jest podłączone do zasilania i połączone z Wi-Fi, Chrome prosi o aktualizację WebAPK z serwera. Po zaktualizowaniu wszystkie pola z nowego pliku manifestu będą .

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 wydłużyć okres sprawdzania do 30 dni;

Testowanie aktualizacji pliku manifestu

Strona about://webapks zawiera szczegółowe informacje na temat aplikacje PWA zainstalowane na urządzeniu, które mogą informować o tym, kiedy plik manifestu był ostatni; m.in. jak często są aktualizowane i nie tylko.

Aby ręcznie zaplanować aktualizację pliku manifestu, przez zastąpienie licznika czasu i lokalny plik manifestu wykonaj te czynności:

  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 użyj panelu aplikacji w ustawieniach Androida, aby wymusić zatrzymanie PWA.
  3. W Chrome otwórz about://webapks i kliknij „Aktualizuj” dla PWA. „Stan aktualizacji” powinien zmienić się na „Oczekujący”.
  4. Uruchom PWA i sprawdź, czy została prawidłowo wczytana.
  5. Wyłącz PWA w menedżerze zadań Androida, 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 aktualizacji” powinna zostać zmieniona na „Powodzenie”.

Pliki referencyjne