Cómo maneja Chrome las actualizaciones del manifiesto de la app web

Qué se necesita para cambiar los íconos, los accesos directos, los colores y otros metadatos de tu AWP

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

Cuando se instala una AWP, el navegador usa información del manifiesto de la app web para el nombre, los íconos que esta debe usar y la URL que debe abrirse cuando se inicia la app. Pero ¿qué sucede si necesitas actualizar los atajos de la app o probar un nuevo color de tema? ¿Cuándo y cómo se reflejan esos cambios en el navegador?

En la mayoría de los casos, los cambios deberían reflejarse en uno o dos días después del lanzamiento de la app web progresiva, una vez que se haya actualizado el manifiesto.

Actualizaciones en Chrome para computadoras

Cuando se inicia la AWP o se abre en una pestaña del navegador, Chrome determina la última vez que se verificó el manifiesto local en busca de cambios. Si el manifiesto no se revisó desde la última vez que se inició el navegador o no se revisó en las últimas 24 horas, Chrome realizará una solicitud de red para el manifiesto y, luego, lo comparará con la copia local.

Si cambian algunas propiedades del manifiesto (consulta la lista a continuación), Chrome pone en cola el manifiesto nuevo y, después de que se cierren todas las ventanas, lo instala. Una vez instalados, se actualizan todos los campos del manifiesto nuevo, excepto icons.

¿Qué propiedades activarán una actualización?

  • name
  • short_name
  • display (consulta a continuación)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

¿Qué sucede cuando se actualiza el campo display?

Si actualizas el modo de visualización de tu app de browser a standalone, las apps de los usuarios existentes no se abrirán en una ventana después de la actualización. Hay dos parámetros de configuración de visualización para una app web: el del manifiesto (que tú controlas) y un parámetro de configuración de la ventana o la pestaña del navegador que controla el usuario. Siempre se respeta la preferencia del usuario.

Cómo probar las actualizaciones del manifiesto

La página chrome://web-app-internals (disponible en Chrome 85 o versiones posteriores) incluye información detallada sobre todas las AWP instaladas en el dispositivo y puede ayudarte a comprender cuándo se actualizó el manifiesto por última vez, con qué frecuencia se actualiza y mucho más.

Para forzar manualmente a Chrome que busque un manifiesto actualizado, puedes iniciar Chrome con la marca de línea de comandos --disable-manifest-update-throttle o reiniciar Chrome (usa about://restart). Esta acción restablecerá el cronómetro para que Chrome verifique si hay un manifiesto actualizado la próxima vez que se inicie la AWP. Luego, inicia la AWP. Después de cerrar la AWP, debería actualizarse con las nuevas propiedades del manifiesto.

Referencias

Actualizaciones en Chrome para Android

Cuando se inicia la AWP, Chrome determina la última vez que se verificó si hay cambios en el manifiesto local. Si no se verificó el manifiesto en las últimas 24 horas, Chrome programará una solicitud de red para el manifiesto y, luego, la comparará con la copia local.

Si cambiaron propiedades seleccionadas del manifiesto (consulta la lista a continuación), Chrome pone en cola el nuevo manifiesto y, después de cerrar todas las ventanas de la AWP, el dispositivo se enchufa y se conecta a Wi-Fi, Chrome solicita un WebAPK actualizado al servidor. Una vez que se actualizan, se usan todos los campos del manifiesto nuevo.

¿Qué propiedades activarán una actualización?

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

Si Chrome no puede obtener un manifiesto actualizado del servidor, es posible que aumente el tiempo entre las verificaciones a 30 días.

Cómo probar las actualizaciones del manifiesto

En la página about://webapks, se incluye información detallada sobre todas las AWP instaladas en el dispositivo y se puede indicar cuándo se actualizó el manifiesto por última vez, con qué frecuencia se actualiza y mucho más.

Para programar manualmente una actualización del manifiesto, anula el temporizador y el manifiesto local para hacer lo siguiente:

  1. Enchufa el dispositivo y asegúrate de que esté conectado a Wi-Fi.
  2. Usa el administrador de tareas de Android para cerrar la AWP y, luego, usa el panel de apps en la configuración de Android para forzar la detención de la AWP.
  3. En Chrome, abre about://webapks y haz clic en el botón "Actualizar" de la AWP. El “Estado de la actualización” debería cambiar a “Pendiente”.
  4. Inicia la AWP y verifica que se cargue correctamente.
  5. Usa el administrador de tareas de Android para cerrar la AWP y, luego, usa el panel de apps en la configuración de Android para forzar la detención de la AWP.

Por lo general, la AWP se actualiza en pocos minutos. Una vez completada la actualización, el "Estado de la actualización" debería cambiar a "Finalizada".

Referencias