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 dell'app web per il nome dell'app, le icone che l'app deve utilizzare e l'URL dovrebbe essere aperta all'avvio dell'app. Ma cosa succede se devi aggiornare scorciatoie app o provare un nuovo colore per il tema? Quando e come si verificano questi cambiamenti riflesso nel browser?

Nella maggior parte dei casi, le modifiche dovrebbero essere applicate entro uno o due giorni dal 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 la l'ultima volta che è stata verificata la presenza di modifiche nel manifest locale. Se il file manifest non è stato controllato dall'ultimo avvio del browser o che non sia stato controllato ultime 24 ore, Chrome effettua una richiesta di rete per il manifest, quindi con la copia locale.

Se alcune proprietà selezionate nel file manifest sono cambiate (vedi l'elenco sotto), 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) sono aggiornate.

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 dell'app da browser a standalone, le app degli utenti esistenti non verranno aperte in una finestra dopo l'aggiornamento. Là sono due impostazioni di visualizzazione per un'app web, quella del file manifest (che ) e un'impostazione della scheda del browser o della finestra controllata dall'utente. L'utente la preferenza 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 aggiornato e altro ancora.

Per forzare manualmente Chrome a verificare la presenza di un file manifest aggiornato, puoi avviare Chrome con il flag della riga di comando --disable-manifest-update-throttle o riavvia Chrome (utilizza about://restart), il timer viene reimpostato in modo che Chrome verifica la presenza di un manifest aggiornato al successivo avvio della PWA. Poi avvia la PWA. Dopo aver chiuso la PWA, questa dovrebbe essere aggiornata con il nuovo manifest proprietà.

Riferimenti

Aggiornamenti su Chrome per Android

Quando viene avviata la PWA, Chrome determina l'ultima volta che il manifest locale per verificare la presenza di modifiche. Se il file manifest non è stato controllato negli ultimi 24 ore, Chrome pianificherà una richiesta di rete per il manifest, quindi confronterà con la copia locale.

Se alcune proprietà selezionate nel file manifest sono cambiate (vedi l'elenco sotto), Chrome mette in coda il nuovo manifest e, dopo aver chiuso tutte le finestre della PWA, che il dispositivo sia collegato e connesso alla rete Wi-Fi, Chrome richiede un aggiornamento WebAPK dal server. Dopo l'aggiornamento, tutti i campi del nuovo manifest in uso.

Quali proprietà attiveranno un aggiornamento?

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

Se Chrome non riesce a ricevere un file manifest aggiornato dal server, potrebbe aumenta l'intervallo tra un controllo e l'altro a 30 giorni.

Test degli aggiornamenti del file manifest

La pagina about://webapks include informazioni dettagliate su tutti i le PWA installate sul dispositivo e la data dell'ultima volta in cui è stato pubblicato il manifest. con quale frequenza vengono aggiornate e altro ancora.

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

  1. Collega il dispositivo alla corrente e assicurati che sia connesso alla rete Wi-Fi.
  2. Usa il Task Manager di Android per arrestare la PWA, quindi usa 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" pulsante PWA. "Aggiorna stato" deve diventare "In attesa".
  4. Avvia la PWA e verifica che sia caricata correttamente.
  5. Usa il Task Manager di Android per arrestare la PWA, quindi usa 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, "Aggiorna stato" deve essere impostato su "Riuscito"

Riferimenti