Como o Chrome lida com as atualizações no manifesto do app da Web

O que é necessário para alterar ícones, atalhos, cores e outros metadados do PWA

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

Quando um PWA é instalado, o navegador usa informações do app da Web para o nome do aplicativo, os ícones que o aplicativo deve usar e o URL que deve ser aberto quando o app for iniciado. Mas e se você precisar atualizar atalhos de apps ou testar uma nova cor de tema? Quando e como essas mudanças são feitas refletidas no navegador?

Na maioria dos casos, as alterações devem ser refletidas em um ou dois dias após PWA sendo iniciado após a atualização do manifesto.

Atualizações no Chrome para computador

Quando o PWA é iniciado ou aberto em uma guia do navegador, o Chrome determina última vez que houve uma verificação de mudanças no manifesto local. Se o manifesto não tiver sido foi verificado desde que o navegador foi iniciado pela última vez ou não foi verificado no últimas 24 horas, o Chrome fará uma solicitação de rede para o manifesto e, em seguida, e compará-los com a cópia local.

Se algumas propriedades do manifesto tiverem sido alteradas (confira a lista abaixo), o Chrome coloca o novo manifesto em fila e, depois que todas as janelas são fechadas, o instala. Depois de instalado, todos os campos do novo manifesto (exceto name, short_name, e icons) são atualizados.

Quais propriedades acionarão uma atualização?

  • display (confira abaixo)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers
. .

O que acontece quando o campo display é atualizado?

Se você atualizar o modo de exibição do seu app de browser para standalone, seu Os usuários existentes não terão seus aplicativos abertos em uma janela após a atualização. há duas configurações de exibição para um app da Web, a do manifesto (que você ) e uma configuração de janela/guia no navegador controlada pelo usuário. O usuário preferência é sempre respeitada.

Como testar atualizações de manifesto

A página chrome://web-app-internals (disponível no Chrome 85 ou versões posteriores) inclui informações detalhadas sobre todos os PWAs instalados no dispositivo, e pode ajudar a entender quando o manifesto foi atualizado pela última vez, com que frequência ele está atualizado e muito mais.

Para forçar manualmente o Chrome a verificar se há um manifesto atualizado, inicie Chrome com a sinalização de linha de comando --disable-manifest-update-throttle ou reiniciar o Chrome (use about://restart), isso redefinirá o timer para que o Chrome vai verificar se há um manifesto atualizado na próxima vez que o PWA for iniciado. Em seguida, inicie o PWA. Depois de fechar o PWA, ele será atualizado com o novo manifesto. propriedades.

Referências

Atualizações no Google Chrome para Android

Quando o PWA é iniciado, o Chrome determina a última vez que o manifesto local foi verificado quanto a alterações. Se o manifesto não tiver sido verificado nos últimos 24 horas, o Chrome agendará uma solicitação de rede para o manifesto e comparará com a cópia local.

Se algumas propriedades do manifesto tiverem sido alteradas (confira a lista abaixo), o Chrome coloca o novo manifesto em fila e, depois que todas as janelas do PWA forem fechadas, o dispositivo estiver conectado à tomada e ao Wi-Fi, o Chrome solicitará uma WebAPK do servidor. Após a atualização, todos os campos do novo manifesto são usados.

Quais propriedades acionarão uma atualização?

  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Se o Chrome não conseguir receber um manifesto atualizado do servidor, ele pode aumentar o tempo entre as verificações para 30 dias.

Como testar atualizações de manifesto

A página about://webapks inclui informações detalhadas sobre todos os Os PWAs instalados no dispositivo e podem informar quando o manifesto foi usado pela última vez atualizados, com que frequência são atualizados e muito mais.

Para agendar manualmente uma atualização do manifesto, modifique o timer e manifesto local, faça o seguinte:

  1. Conecte o dispositivo e confira se ele está conectado ao Wi-Fi.
  2. Usar o gerenciador de tarefas do Android para encerrar o PWA e usar o painel do app nas configurações do Android para forçar o fechamento do PWA.
  3. No Chrome, abra about://webapks e clique em "Atualizar" para o PWA. "Status da atualização" deve mudar para "Pendente".
  4. Inicie o PWA e verifique se ele foi carregado corretamente.
  5. Usar o gerenciador de tarefas do Android para encerrar o PWA e usar o painel do app nas configurações do Android para forçar o fechamento do PWA.

O PWA geralmente é atualizado em alguns minutos. "Status da atualização" deve mudar para "Bem-sucedido"

Referências