Comment Chrome gère les mises à jour du fichier manifeste de l'application Web

Comment modifier les icônes, les raccourcis, les couleurs et d'autres métadonnées de votre PWA ?

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

Lorsqu'une PWA est installée, le navigateur utilise les informations de l'application Web le nom de l'application, les icônes qu'elle doit utiliser et l'URL doit s'ouvrir au lancement de l'application. Mais que se passe-t-il si vous devez mettre à jour des raccourcis vers l'appli ou essayer une nouvelle couleur de thème ? Quand et comment ces changements répercutée dans le navigateur ?

Dans la plupart des cas, les modifications sont prises en compte dans un délai d'un à deux PWA en cours de lancement après la mise à jour du fichier manifeste.

Mises à jour de Chrome pour ordinateur

Lorsque la PWA est lancée ou ouverte dans un onglet de navigateur, Chrome détermine la dernière fois que le fichier manifeste local a été vérifié pour vérifier si des modifications étaient apportées. Si le fichier manifeste n'a pas depuis le dernier démarrage du navigateur, ou si elle n'a pas été vérifiée dans la dernières 24 heures, Chrome envoie une demande réseau pour le fichier manifeste, puis le comparer à la copie locale.

Si certaines propriétés du fichier manifeste ont changé (voir la liste ci-dessous), Chrome met le nouveau fichier manifeste en file d'attente et l'installe une fois toutes les fenêtres fermées. Une fois l'installation effectuée, tous les champs du nouveau fichier manifeste (sauf name, short_name, et icons) sont mis à jour.

Quelles propriétés déclencheront une mise à jour ?

  • display (voir ci-dessous)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

Que se passe-t-il lorsque le champ display est mis à jour ?

Si vous mettez à jour le mode d'affichage de votre application de browser à standalone, votre les applications des utilisateurs existants ne s'ouvriront pas dans une fenêtre après la mise à jour. Il y sont deux paramètres d'affichage d'une application Web, celui tiré du fichier manifeste (que vous commande), et un paramètre d'onglet de fenêtre ou de navigateur contrôlé par l'utilisateur. L'utilisateur la préférence est toujours respectée.

Tester les mises à jour du fichier manifeste

La page chrome://web-app-internals (disponible dans Chrome 85 ou version ultérieure) comprend des informations détaillées sur toutes les PWA installées sur l'appareil, et peut vous aider à comprendre quand le fichier manifeste a été mis à jour pour la dernière fois, à quelle fréquence il est mis à jour, et plus encore.

Pour forcer manuellement Chrome à rechercher un fichier manifeste mis à jour, vous pouvez lancer Chrome avec l'indicateur de ligne de commande --disable-manifest-update-throttle ou redémarrez Chrome (utilisez about://restart), cela réinitialise le minuteur pour que Chrome recherche un fichier manifeste mis à jour lors du prochain lancement de la PWA. Puis lancez la PWA. Une fois la PWA fermée, elle doit être mise à jour avec le nouveau fichier manifeste. propriétés.

Références

Mises à jour de Chrome pour Android

Lors du lancement de la PWA, Chrome détermine la date et l'heure de la dernière fois où le fichier manifeste local a été vérifié afin de vérifier qu'il n'y avait pas de modifications. Si le fichier manifeste n'a pas été vérifié au cours des 24 derniers jours heures, Chrome planifie une requête réseau pour le fichier manifeste, puis compare par rapport à la copie locale.

Si certaines propriétés du fichier manifeste ont changé (voir la liste ci-dessous), Chrome met le nouveau fichier manifeste en file d'attente et après la fermeture de toutes les fenêtres de la PWA, l'appareil est branché et connecté au Wi-Fi, Chrome demande WebAPK à partir du serveur. Une fois mis à jour, tous les champs du nouveau fichier manifeste sont utilisé.

Quelles propriétés déclencheront une mise à jour ?

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

Si Chrome ne parvient pas à obtenir un fichier manifeste mis à jour sur le serveur, il se peut augmenter le délai entre les vérifications à 30 jours.

Tester les mises à jour du fichier manifeste

La page about://webapks contient des informations détaillées sur toutes les PWA installées sur l'appareil, et peuvent vous indiquer la date de la dernière mis à jour, la fréquence de mise à jour, etc.

Pour programmer manuellement une mise à jour du fichier manifeste, en ignorant le minuteur et le fichier manifeste local effectuent les opérations suivantes:

  1. Branchez l'appareil et assurez-vous qu'il est connecté au Wi-Fi.
  2. Arrêtez la PWA à l'aide du gestionnaire de tâches Android, puis utilisez le panneau des applications dans les paramètres Android pour forcer l'arrêt de la PWA.
  3. Dans Chrome, ouvrez about://webapks, puis cliquez sur le bouton "Mettre à jour". pour la ou PWA. "Mettre à jour l'état" doit passer à "En attente".
  4. Lancez la PWA et vérifiez qu'elle est chargée correctement.
  5. Arrêtez la PWA à l'aide du gestionnaire de tâches Android, puis utilisez le panneau des applications dans les paramètres Android pour forcer l'arrêt de la PWA.

La PWA se met généralement à jour en quelques minutes, une fois la mise à jour terminée, "Mettre à jour l'état" doit passer à "Réussie"

Références