Aggiornamenti Delta

Capgo's sistema di aggiornamento Live Update può inviare aggiornamenti più velocemente e in modo più efficiente inviando solo i file modificati, anziché l'intero bundle JS.

This è particolarmente utile per gli utenti con connessioni di rete più lente o tarificate, poiché riduce la quantità di dati che devono essere scaricati.

Un secondo beneficio è quando l'applicazione ha grandi risorse che cambiano raramente, come immagini o video, rispetto ai file JS compressi, 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 flag Capgo, Capgo fa le seguenti cose: --delta flag, Capgo does the following:

1. Vengono generate le checksum per ogni file
2. Viene creato un nuovo manifesto json, che elenca tutti i file e le loro checksum
3. Questo manifesto viene caricato nel database di Capgo
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.

Capgo

Manifesto

In caso di aggiornamenti Delta (manifesto), il dispositivo memorizza tutti i file scaricati in una cache comune. Capgo non la pulisce mai, ma il sistema operativo può farlo in qualsiasi momento.

Abilita Aggiornamenti Delta (Manifesto)

Per abilitare gli aggiornamenti Delta (manifesto) per la tua Capgo app, basta utilizzare la --delta finestra del terminale

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

è abilitato nel tuo directUpdate , il __CAPGO_KEEP_0__ lo rileva. In ambienti non interattivi invia gli aggiornamenti Delta (manifesto) automaticamente, mentre in ambienti interattivi ti chiede di confermare prima di caricare. Utilizza capacitor.config, the CLI detects it. In non-interactive environments it sends Delta (manifest) updates automatically, and in interactive environments it prompts you to confirm before uploading. Use --no-delta per forzare l'upload di un bundle completo.

Aggiornamenti Delta (Manifesto)

Se desideri assicurarti che tutti gli upload siano aggiornamenti Delta (manifesto) e prevenire eventuali upload di bundle completi accidentali, puoi utilizzare il --delta-only flag:

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

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

Potresti voler utilizzare --delta-only se:

• Vuoi sempre utilizzare gli aggiornamenti Delta (manifesto) e non vuoi mai consentire gli upload di bundle completi
• Stai configurando un flusso di lavoro CI/CD e desideri assicurarti che tutte le upload automatizzate siano Delta (manifesto)
• La tua app è grande e la larghezza di banda è limitata, quindi hai bisogno di ridurre le dimensioni degli upload e dei download

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

Risoluzione dei problemi

Se gli aggiornamenti 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 invii una nuova versione
• Se utilizzando --delta-onlyassicurati di non aver dimenticato di includere il --delta bandiera
• 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

Puoi anche utilizzare la Capgo webapp per verificare i dettagli della tua ultima caricamento:

1. Vai al webapp
2. Clicca sul tuo app
3. Clicca sul numero dei bundle della barra delle statistiche.
4. Seleziona l'ultimo bundle
5. Verifica il Partial campo

Se continuate a incontrare difficoltà, per favore contattate il supporto di Capgo per ulteriore assistenza. Possono verificare i registri del server per confermare che le vostre upload di Delta (manifesto) stanno essere elaborati correttamente e che i dispositivi stanno ricevendo gli aggiornamenti dei manifesti.

Quello è 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 dovete utilizzare --delta ogni volta che pubblicate una nuova versione che desiderate essere consegnata come aggiornamento di Delta (manifesto). Se omettete la bandiera, Capgo caricherà l'intero bundle JS come un file singolo, e i dispositivi scaricheranno l'intero bundle anche se è cambiato solo una piccola parte.