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 del lancio dell'app. Ma cosa succede se devi aggiornare le scorciatoie 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 dall'avvio della PWA, dopo l'aggiornamento del 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. Al termine dell'installazione, vengono aggiornati tutti i campi del nuovo manifest, ad eccezione di icons.

Quali proprietà attiveranno un aggiornamento?

  • name
  • short_name
  • 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 controlli da te) 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 manifest, la frequenza con cui 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 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 pianificherà una richiesta di rete per il manifest, quindi la confronterà con la copia locale.

Se alcune proprietà selezionate nel file manifest sono cambiate (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. 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 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 gestore delle app 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