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

Qué se necesita para cambiar los íconos, las combinaciones de teclas, los colores y otros metadatos de tu AWP

Adriana Jara
Francisco Beaufort
François Beaufort
GitHub
Pete LePage

Cuando se instala una AWP, el navegador usa la información del manifiesto de la app web para el nombre, los íconos que esta debe usar y la URL que se debe abrir cuando se inicia la app. Pero ¿qué sucede si necesitas actualizar los accesos directos a 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 un día o dos desde el momento en que se inicia la AWP, después de que se actualice el manifiesto.

Actualizaciones de la versión de 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ó la última vez que se verificó la AWP en busca de cambios. Si no se verificó el manifiesto desde que se inició el navegador por última vez o no se verificó en las últimas 24 horas, Chrome realizará una solicitud de red para el manifiesto y, luego, lo comparará con la copia local.

Si cambiaron algunas propiedades del manifiesto (consulta la lista a continuación), Chrome pone en cola el nuevo manifiesto 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. Hay dos opciones de configuración de pantalla para una app web: la del manifiesto (que tú controlas) y una configuración de pestaña de ventana o navegador controlada por el usuario. Siempre se respetará la preferencia del usuario.

Cómo probar 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 actualizó y mucho más.

Para forzar manualmente a que Chrome 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 busque un manifiesto actualizado la próxima vez que se inicie la AWP. Luego, inicia la AWP. Después de cerrar la AWP, esta 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ó la última vez que se verificaron cambios en el manifiesto local. Si el manifiesto no se revisó en las últimas 24 horas, Chrome programará una solicitud de red para el manifiesto y, luego, lo comparará con la copia local.

Si cambiaron las propiedades seleccionadas del manifiesto (consulta la lista a continuación), Chrome pone en cola el manifiesto nuevo y, después de que se cierran todas las ventanas de la AWP, se enchufa el dispositivo y se conecta a Wi-Fi, Chrome solicita un WebAPK actualizado del servidor. Una vez que se complete la actualización, 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 aumente a 30 días.

Cómo probar actualizaciones del manifiesto

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

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

  1. Conecta 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" debe cambiar a "Pendiente".
  4. Inicia la AWP y verifica que se haya cargado 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 unos minutos. Una vez completada la actualización, el "Estado de la actualización" debería cambiar a "Finalizada".

Referencias