Как Chrome обрабатывает обновления манифеста веб-приложения

Что нужно для изменения значков, ярлыков, цветов и других метаданных для вашего PWA

Адриана Хара
Франсуа Бофор
François Beaufort
GitHub
Пит ЛеПейдж

При установке PWA браузер использует информацию из манифеста веб-приложения для имени приложения, значков, которые оно должно использовать, и URL-адреса, который должен открываться при запуске приложения. Но что делать, если вам нужно обновить ярлыки приложений или попробовать новый цвет темы? Когда и как эти изменения отражаются в браузере?

В большинстве случаев изменения должны быть отражены в течение одного-двух дней после запуска PWA, после обновления манифеста.

Обновления Chrome для ПК

При запуске PWA или открытии во вкладке браузера Chrome определяет время последней проверки локального манифеста на наличие изменений. Если манифест не проверялся с момента последнего запуска браузера или в течение последних 24 часов, Chrome выполнит сетевой запрос манифеста и сравнит его с локальной копией.

Если некоторые свойства манифеста изменились (см. список ниже), Chrome добавляет новый манифест в очередь и после закрытия всех окон устанавливает его. После установки все поля нового манифеста, за исключением icons обновляются.

Какие свойства вызовут обновление?

  • name
  • short_name
  • display (см. ниже)
  • scope
  • shortcuts
  • start_url : для изменения start_url требуется указать id манифеста. Подробнее .
  • theme_color
  • file_handlers

Что происходит при обновлении поля display ?

Если вы измените режим отображения приложения с browser на standalone , у существующих пользователей приложения не будут открываться в окне после обновления. Для веб-приложения существует два параметра отображения: параметр из манифеста (который контролируется вами) и параметр окна и вкладки браузера, настраиваемый пользователем. Настройки пользователя всегда учитываются.

Тестирование обновлений манифеста

Страница chrome://web-app-internals (доступна в Chrome 85 и более поздних версиях) содержит подробную информацию обо всех PWA, установленных на устройстве, и может помочь вам понять, когда в последний раз обновлялся манифест, как часто он обновляется и многое другое.

Чтобы вручную заставить Chrome проверить наличие обновлённого манифеста, можно запустить Chrome с флагом командной строки --disable-manifest-update-throttle или перезапустить Chrome (используйте about://restart ). Это сбросит таймер, и Chrome проверит наличие обновлённого манифеста при следующем запуске PWA. Затем запустите PWA. После закрытия PWA он должен обновиться с учётом новых свойств манифеста.

Ссылки

Обновления Chrome для Android

При запуске PWA Chrome определяет время последней проверки локального манифеста на наличие изменений. Если манифест не проверялся в течение последних 24 часов, Chrome запланирует сетевой запрос манифеста и сравнит его с локальной копией.

Если некоторые свойства в манифесте изменились (см. список ниже), Chrome добавляет новый манифест в очередь, и после закрытия всех окон PWA, подключения устройства к сети и Wi-Fi Chrome запрашивает обновлённый WebAPK с сервера. После обновления используются все поля из нового манифеста.

Какие свойства запускают обновление?

  • name
  • short_name
  • icons
  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Если Chrome не может получить обновленный манифест с сервера, время между проверками может увеличиться до 30 дней.

Тестовые обновления манифеста

Страница about://webapks содержит подробную информацию обо всех PWA, установленных на устройстве, а также может сообщить вам, когда в последний раз обновлялся манифест, как часто он обновляется и многое другое.

Чтобы вручную запланировать обновление манифеста, переопределив таймер и локальный манифест, выполните следующие действия:

  1. Подключите устройство и убедитесь, что оно подключено к Wi-Fi.
  2. Используйте диспетчер задач Android для завершения работы PWA, затем используйте панель приложений в настройках Android для принудительной остановки PWA.
  3. В Chrome откройте about://webapks и нажмите кнопку «Обновить» для PWA. Статус обновления должен измениться на «Ожидает».
  4. Запустите PWA и убедитесь, что он загружен правильно.
  5. Используйте диспетчер задач Android для завершения работы PWA, затем используйте панель приложений в настройках Android для принудительной остановки PWA.

PWA обычно обновляется в течение нескольких минут. После завершения обновления «Статус обновления» должен измениться на «Успешно».

Ссылки