Modalità di gestione degli aggiornamenti del file manifest dell'app web in Chrome

Cosa serve per cambiare icone, scorciatoie, colori e altri metadati per la tua PWA

Adriano Barbieri
Francesco Beaufort
François Beaufort
GitHub
Roberto Battaglia

Quando è installata una PWA, il browser utilizza le informazioni del file manifest dell'app web per il nome dell'app, le icone che dovrebbe utilizzare e l'URL che deve essere aperto all'avvio dell'app. E se avessi bisogno di aggiornare le scorciatoie app o provare un nuovo colore del tema? Quando e come queste modifiche vengono applicate nel browser?

Nella maggior parte dei casi, le modifiche dovrebbero essere applicate entro uno o due giorni dall'avvio della PWA, dopo l'aggiornamento del manifest.

Aggiornamenti su Chrome per computer

Quando la PWA viene avviata o aperta in una scheda del browser, Chrome determina l'ultima volta in cui il manifest locale è stato controllato per verificare la presenza di modifiche. Se il file manifest non è stato controllato dall'ultimo avvio del browser o se non è stato controllato nelle ultime 24 ore, Chrome effettua una richiesta di rete per il file manifest, quindi lo confronta con la copia locale.

Se le proprietà selezionate nel file manifest sono cambiate (vedi l'elenco di seguito), Chrome mette in coda il nuovo file manifest e, dopo la chiusura di tutte le finestre, lo installa. Una volta installato, tutti i campi del nuovo manifest (tranne name, short_name e icons) vengono aggiornati.

Quali proprietà attiveranno un aggiornamento?

  • display (vedi sotto)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

Che cosa succede quando il campo display viene aggiornato?

Se aggiorni la modalità di visualizzazione dell'app da browser a standalone, gli utenti esistenti non vedranno le app aperte in una finestra dopo l'aggiornamento. Per un'app web sono disponibili due impostazioni di visualizzazione: una nel file manifest (che controlli tu) e un'impostazione di finestra/scheda del browser controllata dall'utente. La preferenza dell'utente viene sempre rispettata.

Test degli aggiornamenti del file manifest

La pagina chrome://web-app-internals (disponibile in Chrome 85 o versioni successive) include informazioni dettagliate su tutte le PWA installate sul dispositivo e può aiutarti a capire quando è stato eseguito l'ultimo aggiornamento del file manifest, con quale frequenza viene aggiornato e altro ancora.

Per forzare manualmente a verificare la presenza di un manifest aggiornato in Chrome, puoi avviare Chrome con il flag della riga di comando --disable-manifest-update-throttle o riavviare Chrome (utilizzando about://restart). In questo modo il timer viene reimpostato in modo che Chrome verifichi la presenza di un manifest aggiornato al successivo avvio della PWA. Poi avvia la PWA. Dopo aver chiuso la PWA, deve essere aggiornata con le nuove proprietà del manifest.

Riferimenti

Aggiornamenti su Chrome per Android

Quando viene avviata la PWA, Chrome determina l'ultima volta in cui il manifest locale è stato controllato per verificare la presenza di modifiche. Se il file manifest non è stato controllato nelle ultime 24 ore, Chrome pianifica una richiesta di rete per il manifest, quindi lo confronta con la copia locale.

Se le proprietà selezionate nel manifest sono cambiate (vedi l'elenco di seguito), Chrome mette in coda il nuovo manifest e, dopo che tutte le finestre della PWA sono state chiuse, il dispositivo è collegato e connesso al Wi-Fi, Chrome richiede un WebAPK aggiornato al server. Una volta aggiornato, vengono utilizzati tutti i campi del nuovo manifest.

Quali proprietà attiveranno un aggiornamento?

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

Se Chrome non riesce a recuperare un manifest aggiornato dal server, potrebbe aumentare il tempo tra i controlli a 30 giorni.

Test degli aggiornamenti del file manifest

La pagina about://webapks include informazioni dettagliate su tutte le PWA installate sul dispositivo e può indicare la data dell'ultimo aggiornamento del manifest, la frequenza con cui viene aggiornato e altro ancora.

Per pianificare manualmente un aggiornamento del file manifest, eseguendo l'override del timer e del file manifest locale:

  1. Collega il dispositivo alla corrente e assicurati che sia connesso al Wi-Fi.
  2. Utilizza il Task Manager di Android per arrestare la PWA, quindi utilizza il riquadro App nelle impostazioni di Android per forzarne l'interruzione.
  3. In Chrome, apri about://webapks e fai clic sul pulsante "Aggiorna" della PWA. Lo "stato aggiornamento" dovrebbe diventare "In attesa".
  4. Avvia la PWA e verifica che sia caricata correttamente.
  5. Utilizza il Task Manager di Android per arrestare la PWA, quindi utilizza il riquadro App nelle impostazioni di Android per forzarne l'interruzione.

Generalmente la PWA si aggiorna entro pochi minuti e, una volta completato l'aggiornamento, lo "stato di aggiornamento" dovrebbe diventare "Riuscito"

Riferimenti