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

Zmiana ikon, skrótów, kolorów i innych metadanych w aplikacji PWA

Adriana Jara
Anna Beaufort
François Beaufort
GitHub
Piotr LePage

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

W większości przypadków zmiany powinny pojawić się w ciągu 1–2 dni od wprowadzenia PWA (po zaktualizowaniu pliku manifestu).

Aktualizacje Chrome na komputery

Po uruchomieniu PWA lub otwarciu karty 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 nie był sprawdzany w ciągu ostatnich 24 godzin, Chrome wyśle żądanie sieciowe dotyczące pliku manifestu, a następnie porówna go z kopią lokalną.

Jeśli wybrane usługi w pliku manifestu uległy zmianie (zobacz listę poniżej), Chrome doda nowy plik manifestu do kolejki i zainstaluje go po zamknięciu wszystkich okien. Po zainstalowaniu nowego pliku manifestu (z wyjątkiem name, short_name i icons) zostaną zaktualizowane wszystkie pola z nowego pliku manifestu.

Które usługi wyzwalają aktualizację?

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

Co się stanie, gdy pole display zostanie zaktualizowane?

Jeśli zmienisz tryb wyświetlania aplikacji z browser na standalone, po aktualizacji istniejący użytkownicy nie będą mogli otwierać swoich aplikacji w oknie. Aplikacja internetowa ma 2 ustawienia wyświetlania: jedno z pliku manifestu (który kontrolujesz) oraz ustawienie karty okna/przeglądarki kontrolowane przez użytkownika. Ustawienie użytkownika jest zawsze respektowane.

Testowanie aktualizacji pliku manifestu

Strona chrome://web-app-internals (dostępna w Chrome 85 i nowszych) zawiera szczegółowe informacje o wszystkich aplikacjach PWA zainstalowanych na urządzeniu oraz pomaga ustalić, kiedy plik manifestu był ostatnio aktualizowany, jak często jest aktualizowany itp.

Aby ręcznie wymusić sprawdzenie w Chrome aktualizacji pliku manifestu, możesz uruchomić Chrome z flagą wiersza polecenia --disable-manifest-update-throttle lub ponownie uruchomić Chrome (użyj about://restart). Powoduje to zresetowanie licznika czasu, dzięki czemu Chrome sprawdza dostępność zaktualizowanego pliku manifestu przy następnym uruchomieniu PWA. Następnie uruchom PWA. Po zamknięciu aplikacji PWA należy zaktualizować ją o nowe właściwości pliku manifestu.

Odniesienia

Aktualizacje Chrome na Androida

Po uruchomieniu PWA Chrome określa, kiedy lokalny plik manifestu był ostatnio sprawdzany pod kątem zmian. Jeśli plik manifestu nie został sprawdzony w ciągu ostatnich 24 godzin, Chrome zaplanuje wysłanie żądania sieciowego do pliku manifestu, 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 doda do kolejki nowy plik manifestu, a po zamknięciu wszystkich okien aplikacji PWA oraz podłączeniu urządzenia do zasilania i połączeniu z Wi-Fi Chrome wyśle do serwera żądanie zaktualizowanego pliku WebAPK. Po aktualizacji używane są wszystkie pola z nowego pliku manifestu.

Które usługi wyzwalają 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ć się czas między kontrolami 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 informacje o tym, kiedy plik manifestu był ostatnio aktualizowany, jak często jest aktualizowany itp.

Aby ręcznie zaplanować aktualizację pliku manifestu, zastąp licznik czasu i plik manifestu lokalnego. Wykonaj te czynności:

  1. Podłącz urządzenie do zasilania i sprawdź, czy jest połączone z Wi-Fi.
  2. Wyłącz PWA w Menedżerze zadań Androida, a następnie w panelu aplikacji w ustawieniach Androida wymuś jego zatrzymanie.
  3. W Chrome otwórz about://webapks i kliknij przycisk „Aktualizuj” aplikacji PWA. „Stan aktualizacji” powinien zmienić się na „Oczekująca”.
  4. Uruchom progresywną aplikację internetową i sprawdź, czy wczytuje się prawidłowo.
  5. Wyłącz PWA w Menedżerze zadań Androida, a następnie w panelu aplikacji w ustawieniach Androida wymuś jego zatrzymanie.

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

Odniesienia