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é pasa si necesitas actualizar atajos de aplicaciones 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 deben reflejarse en uno o dos días después de iniciar la AWP, después de actualizar el manifiesto.

Actualizaciones en Chrome para computadoras de escritorio

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

Si cambiaron algunas propiedades del manifiesto (consulta la lista a continuación), Chrome pone en cola el manifiesto nuevo y, una vez que se cierran todas las ventanas, lo instala. Una vez instalado, se actualizan todos los campos del manifiesto nuevo (excepto name, short_name y icons).

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

  • display (ver 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. Existen dos opciones de configuración de visualización para una app web: una del manifiesto (que tú controlas) y una configuración de la ventana o pestaña del navegador que controla el usuario. La preferencia del usuario siempre se respeta.

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). De esta manera, se restablecerá el temporizador 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 actualizado, se usarán todos los campos del manifiesto nuevo.

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

  • 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 el tiempo entre las verificaciones se aumente 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 la app 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 esté cargada correctamente.
  5. Usa el Administrador de tareas de Android para cerrar la AWP y, luego, usa el panel de la app 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