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

Ce qu'il faut pour 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 du fichier manifeste de l'application Web pour le nom de l'application, les icônes qu'elle doit utiliser et l'URL qui doit être ouverte lors du lancement de l'application. Mais que faire si vous devez modifier les raccourcis d'application ou essayer une nouvelle couleur de thème ? Quand et comment ces modifications sont-elles reflétées dans le navigateur ?

Dans la plupart des cas, les modifications devraient être visibles un ou deux jours après le lancement de la PWA, une fois le fichier manifeste mis à jour.

Modifications apportées à Chrome sur 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 détecter des modifications. Si le fichier manifeste n'a pas été vérifié depuis le dernier démarrage du navigateur ou au cours des dernières 24 heures, Chrome envoie une requête réseau pour le fichier manifeste, puis le compare à 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 que toutes les fenêtres ont été fermées. Une fois installé, tous les champs du nouveau fichier manifeste, à l'exception de icons, sont mis à jour.

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

  • name
  • short_name
  • display (voir ci-dessous)
  • scope
  • shortcuts
  • start_url Attention : Les modifications apportées à start_url nécessitent la définition du id manifeste. En savoir plus
  • theme_color
  • file_handlers

Que se passe-t-il lorsque le champ display est modifié ?

Si vous modifiez le mode d'affichage de votre application de browser à standalone, les utilisateurs existants ne verront pas leurs applications s'ouvrir dans une fenêtre après la mise à jour. Il existe deux paramètres d'affichage pour une application Web : celui du fichier manifeste (que vous contrôlez) et un paramètre de fenêtre et d'onglet de navigateur contrôlé par l'utilisateur. La préférence de l'utilisateur 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) inclut des informations détaillées sur toutes les PWA installées sur l'appareil. Elle peut vous aider à comprendre quand le fichier manifeste a été mis à jour pour la dernière fois, à quelle fréquence il est mis à jour, etc.

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émarrer Chrome (en utilisant about://restart). Cela réinitialise le minuteur afin que Chrome recherche un fichier manifeste mis à jour lors du prochain lancement de la PWA. Lancez ensuite la PWA. Une fois la PWA fermée, elle doit être mise à jour avec les nouvelles propriétés du fichier manifeste.

Références

Nouveautés de Chrome pour Android

Lorsque la PWA est lancée, Chrome détermine la dernière fois que le fichier manifeste local a été vérifié pour détecter des modifications. Si le fichier manifeste n'a pas été vérifié au cours des dernières 24 heures, Chrome planifiera une requête réseau pour le fichier manifeste, puis le comparera à la copie locale.

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

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

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

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

Tester les mises à jour du fichier manifeste

La page about://webapks inclut des informations détaillées sur toutes les PWA installées sur l'appareil. Elle peut vous indiquer la date de la dernière mise à jour du fichier manifeste, la fréquence des mises à jour, etc.

Pour planifier manuellement une mise à jour du fichier manifeste, en ignorant le minuteur et le fichier manifeste local, procédez comme suit :

  1. Branchez l'appareil et assurez-vous qu'il est connecté au Wi-Fi.
  2. Utilisez le gestionnaire de tâches Android pour fermer la PWA, puis utilisez le panneau "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 PWA. L'état "Mise à jour de l'état" doit passer à "En attente".
  4. Lancez la PWA et vérifiez qu'elle se charge correctement.
  5. Utilisez le gestionnaire de tâches Android pour fermer la PWA, puis utilisez le panneau "Applications" dans les paramètres Android pour forcer l'arrêt de la PWA.

La PWA est généralement mise à jour en quelques minutes. Une fois la mise à jour terminée, l'état de la mise à jour doit passer à "Réussie".

Références