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

Cosa serve per modificare icone, scorciatoie, colori e altri metadati della tua PWA

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

Quando viene installata una PWA, il browser utilizza le informazioni del manifest dell'app web per il nome dell'app, le icone che deve utilizzare e l'URL che deve essere aperto al momento dell'avvio dell'app. E se devi aggiornare le scorciatoie delle app o provare un nuovo colore del tema? Quando e come vengono applicate queste modifiche nel browser?

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

Aggiornamenti su Chrome per computer

Quando la PWA viene lanciata o aperta in una scheda del browser, Chrome determina la ultima volta che è stato controllato se sono presenti modifiche nel file manifest locale. Se il manifest non è stato controllato dall'ultima volta che è stato avviato il browser o non è stato controllato nelle ultime 24 ore, Chrome invia una richiesta di rete per il manifest e lo confronta con la copia locale.

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

Quali proprietà attiveranno un aggiornamento?

  • name
  • short_name
  • display (vedi di seguito)
  • 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, le app degli utenti esistenti non verranno aperte in una finestra dopo l'aggiornamento. Esistono due impostazioni di visualizzazione per un'app web: quella del file manifest (che puoi controllare) e un'impostazione della finestra/scheda del browser controllata dall'utente. La preferenza dell'utente viene sempre rispettata.

Test degli aggiornamenti del 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 aggiornato l'ultimo manifest, la frequenza con cui viene aggiornato e altro ancora.

Per forzare manualmente Chrome a verificare la presenza di un manifest aggiornato, puoi avviare Chrome con il flag della riga di comando --disable-manifest-update-throttle o riavviare Chrome (utilizza 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. Quindi avvia la PWA. Dopo aver chiuso la PWA, questa dovrebbe essere aggiornata con le nuove proprietà del manifest.

Riferimenti

Aggiornamenti su Chrome per Android

Quando la PWA viene lanciata, Chrome determina l'ultima volta che è stato eseguito il controllo delle modifiche al file manifest locale. Se il 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 alcune proprietà 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 alla corrente e alla rete Wi-Fi, Chrome richiede un WebAPK aggiornato dal server. Una volta aggiornato, tutti i campi del nuovo manifest vengono utilizzati.

Quali proprietà attiveranno un aggiornamento?

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

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

Test degli aggiornamenti del manifest

La pagina about://webapks include informazioni dettagliate su tutti i PWA installati sul dispositivo e può indicare quando è stato aggiornato l'ultimo manifest, la frequenza con cui viene aggiornato e altro ancora.

Per pianificare manualmente un aggiornamento del manifest, sostituendo il timer e il manifest locale:

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

In genere, la PWA si aggiorna entro pochi minuti. Al termine dell'aggiornamento, lo stato "Aggiornamento stato" dovrebbe cambiare in "Completato".

Riferimenti