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

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

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

Quando viene installata una PWA, il browser utilizza le informazioni del file manifest dell'app web per il nome dell'app, le icone che l'app deve utilizzare e l'URL che deve essere aperto all'avvio dell'app. Ma cosa succede se devi aggiornare le scorciatoie app o provare un nuovo colore del tema? Quando e come si riflettono queste modifiche 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 che 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 confronterà con la copia locale.

Se alcune proprietà selezionate nel manifest sono cambiate (vedi l'elenco di seguito), Chrome mette in coda il nuovo manifest e, dopo aver chiuso tutte le finestre, lo installa. Dopo l'installazione, 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

Cosa succede quando il campo display viene aggiornato?

Se aggiorni la modalità di visualizzazione della tua app da browser a standalone, dopo l'aggiornamento le app non saranno aperte in una finestra per gli utenti esistenti. Esistono due impostazioni di visualizzazione per un'app web: quella del file manifest (che puoi controllare) e un'impostazione della scheda del browser o finestra 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 aggiornato l'ultimo file manifest, con quale frequenza viene aggiornato e altro ancora.

Per forzare manualmente Chrome a controllare la presenza di un manifest aggiornato, 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, questa deve essere aggiornata con le nuove proprietà manifest.

Riferimenti

Aggiornamenti su Chrome per Android

Quando viene avviata la PWA, Chrome determina quando è stata l'ultima volta che è stata controllata la presenza di modifiche nel manifest locale. Se il manifest non è stato controllato nelle ultime 24 ore, Chrome pianificherà una richiesta di rete per il manifest, quindi la confronterà con la copia locale.

Se alcune proprietà selezionate nel file manifest sono state modificate (vedi l'elenco di seguito), Chrome mette in coda il nuovo manifest e, dopo aver chiuso tutte le finestre della PWA, il dispositivo è collegato e connesso al Wi-Fi, Chrome richiede un WebAPK aggiornato al server. Dopo l'aggiornamento, 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 è in grado di ricevere 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 di aggiornamento e altro ancora.

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

  1. Collega il dispositivo alla corrente e assicurati che sia connesso alla rete Wi-Fi.
  2. Utilizza il Task Manager 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 aggiornamento" dovrebbe cambiare in "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 forzare l'interruzione della PWA.

In genere la PWA si aggiorna entro pochi minuti. Una volta completato l'aggiornamento, lo stato di aggiornamento dovrebbe diventare "Riuscito"

Riferimenti