Aggiornamenti di Delta

Il sistema di aggiornamento in tempo reale di Capgo può inviare gli aggiornamenti in modo più veloce e efficiente inviando solo i file modificati, anziché l'intero bundle JS.

Questo è particolarmente utile per gli utenti con connessioni di rete più lente o a tariffa, poiché riduce l'ammontare di dati da scaricare.

Un secondo beneficio è quando l'applicazione ha grandi asset che cambiano raramente, come immagini o video, rispetto ai file JS zippati, verranno scaricati solo una volta.

Come Funzionano gli Aggiornamenti Delta (Manifest)

Gli aggiornamenti delta (manifest) in Capgo sono gestiti dal plugin Capgo installato nell'app. Quando carichi una nuova versione dell'applicazione utilizzando la --delta flag, Capgo esegue le seguenti operazioni:

1. Ogni file nella tua build viene caricato individualmente
2. Vengono generate le checksum per ogni file
3. Viene creato un nuovo manifesto json, che elenca tutti i file e le loro checksum
4. This manifest is uploaded to the Capgo database

When a device running your app checks for an update, the Capgo plugin receives the new manifest from the server. It compares this manifest to the one it currently has, identifying which files have changed based on the checksums and file paths.

The plugin then downloads only the changed files, rather than the entire JS bundle. It reconstructs the new version of the app by combining these downloaded files with the unchanged files it already has.

Manifesto

In caso di aggiornamenti Delta (manifesto), il dispositivo memorizza tutti i file scaricati in una cache comune. Il Capgo non li pulisce mai, ma l'OS può farlo in qualsiasi momento.

Abilita Aggiornamenti Delta (Manifesto)

Per abilitare gli aggiornamenti Delta (manifesto) per il tuo app Capgo, basta utilizzare la --delta flag quando si carica una nuova versione:

npx @capgo/cli@latest bundle upload --delta

Se autoUpdate è impostato in un modalità di applicazione istantanea ("atInstall", "onLaunch", o "always") nel tuo capacitor.config, il CLI lo rileva. In ambienti non interattivi invia aggiornamenti Delta (manifesto) automaticamente, mentre in ambienti interattivi ti chiede di confermare prima di caricare. La configurazione Legacy è ancora rilevata. Utilizza directUpdate per forzare l'upload di un bundle completo. --no-delta Abilita Aggiornamenti Delta (Manifesto)

Sezione intitolata “Abilita Aggiornamenti Delta (Manifesto)”

Finestra del terminale --delta-only Se

npx @capgo/cli@latest bundle upload --delta-only

Quando --delta-only è utilizzato, Capgo caricherà solo i file individuali e genererà un manifesto. Qualsiasi dispositivo che non supporta le aggiornamenti Delta (manifesto) non potrà scaricare l'aggiornamento.

Potresti voler usare --delta-only se:

• Desideri sempre utilizzare gli aggiornamenti Delta (manifesto) e non desideri mai consentire l'upload dei bundle completi
• Stai configurando un flusso di lavoro CI/CD e desideri assicurarti che tutti gli upload automatizzati siano Delta (manifesto)
• La tua app è grande e la banda è limitata, quindi hai bisogno di minimizzare le dimensioni degli upload e dei download

Se hai bisogno di eseguire un upload del bundle completo mentre --delta-only è impostato, basta eseguire il comando di upload senza --delta-only. Questo sovrascriverà la configurazione per quel singolo upload, consentendoti di inviare un bundle completo quando necessario

Risoluzione dei problemi

Se gli aggiornamenti di Delta (manifesto) non sembrano funzionare (ad esempio, i dispositivi scaricano sempre il bundle JS completo anche per piccole modifiche), controlla che:

• Stai utilizzando la --delta flag ogni volta che carichi una nuova versione
• Se utilizzi --delta-only, assicurati di non aver dimenticato di aggiungere la --delta flag
• Il tuo dispositivo sta eseguendo la versione più recente del plugin Capgo
• Il tuo dispositivo ha una connessione di rete stabile e può raggiungere i server Capgo

Potresti anche utilizzare la Capgo webapp per verificare i dettagli dell'ultimo caricamento:

1. Vai alla webapp
2. Click on your app
3. Clicca sul numero dei bundle della barra delle statistiche.
4. Scegli l'ultimo bundle
5. Controlla il Partial campo

Se continui a avere problemi, per favore contatta il supporto Capgo per ulteriore assistenza. Possono verificare i registri del server per confermare che le tue upload di Delta (manifesto) vengono elaborati correttamente e che i dispositivi ricevono gli aggiornamenti dei manifesti.

È tutto! La --delta bandiera indica a Capgo di eseguire gli upload dei file individuali e la generazione del manifesto necessari per gli aggiornamenti di Delta (manifesto).

Nota che devi utilizzare --delta ogni volta che carichi una nuova versione che desideri essere consegnata come aggiornamento di Delta (manifesto). Se ometti la bandiera, Capgo caricherà l'intero bundle JS come un file singolo, e i dispositivi scaricheranno l'intero bundle anche se solo una piccola parte è cambiata.

Continua con gli aggiornamenti di Delta

Se stai utilizzando Aggiornamenti di Delta per pianificare la consegna degli aggiornamenti in tempo reale, connettilo con Capgo Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto in Capgo Aggiornamenti in Tempo Reale, Panoramica per i dettagli di implementazione in Panoramica, Caratteristiche per i dettagli di implementazione in Caratteristiche, Comportamento degli Aggiornamenti per i dettagli di implementazione in Comportamento degli Aggiornamenti Tipi di Aggiornamento per i dettagli di implementazione in Tipi di Aggiornamento.