Aggiornamenti 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é minimizza la quantità di dati da scaricare.

A un secondo beneficio è quando l'applicazione ha grandi risorse 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 Gli aggiornamenti Delta (manifest) in Capgo sono gestiti dal plugin __CAPGO_KEEP_1__ installato nell'app. Quando carichi una nuova versione dell'applicazione utilizzando la

1. Ogni file nella tua build viene caricato individualmente
2. Vengono generate le checksum per ogni file
3. Viene creata una nuova manifestazione JSON, che elenca tutti i file e le loro checksum
4. Questa manifestazione viene caricata nel database di Capgo

Quando un dispositivo che esegue l'app verifica l'aggiornamento, il plugin Capgo riceve la nuova manifestazione dal server. Lo confronta con quella che ha attualmente, identificando quali file sono cambiati in base alle checksum e ai percorsi dei file.

Il plugin scarica quindi solo i file modificati, anziché l'intero bundle JS. Riconstruisce la nuova versione dell'applicazione combinando questi file scaricati con quelli non modificati che già ha.

Manifesto

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

Aggiornamenti Delta (Manifesto)

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

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

è impostato in un modalità di applicazione istantanea ( autoUpdate o"atInstall", "onLaunch") nel tuo "always"Manifest capacitor.configLa CLI rileva, , in ambienti non interattivi invia aggiornamenti Delta (manifesto) automaticamente, mentre in ambienti interattivi ti chiede di confermare prima di caricare. Legacy directUpdate Utilizza --no-delta per forzare l'upload di un bundle completo.

Limitazioni degli aggiornamenti Delta

• File vuoti: La CLI registra Ignoring empty file... e esclude i file di zero byte dal manifesto Delta. Non fallisce l'upload, quindi aggiungere un file vuoto può modificare il bundle risultante senza fermare la tua distribuzione. Non includere file di zero byte nelle percorso dei bundle Delta.
• Spazi nei percorsi: Gli upload Delta falliscono prima di caricare i file quando un percorso del bundle contiene uno spazio. Rinomina il file o la directory per eliminare gli spazi prima di caricare un aggiornamento Delta.

Imponendo Aggiornamenti Delta (Manifesto)

If desideri assicurarti che tutte le upload siano aggiornamenti Delta (manifesto) e prevenire qualsiasi upload di bundle completo accidentale, 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:

• Desideri sempre utilizzare gli aggiornamenti Delta (manifesto) e non desideri 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 banda è limitata, quindi hai bisogno di minimizzare le dimensioni degli upload e dei download

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

Risolvere i problemi

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

• Stai utilizzando il --delta flag ogni volta che carichi una nuova versione
• Se stai utilizzando --delta-onlyassicurati di non aver dimenticato di aggiungere il --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

Puoi utilizzare anche la Capgo web app per verificare i dettagli dell'ultimo upload:

1. Vai alla web app
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 continui a avere problemi, per favore contatta il supporto Capgo per ulteriore assistenza. Possono verificare i log del server per confermare che le tue Delta (manifesto) vengono elaborati correttamente e che i dispositivi ricevono gli aggiornamenti dei manifesti.

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

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

Continua con gli aggiornamenti Delta

Se stai utilizzando Aggiornamenti Delta context: Pagina/Area: Pagina prodotti/prezzi aziendale. Ruolo: Etichetta UI breve o elemento di navigazione. Visto in: pagina enterprise.astro. Messaggio chiave `enterprise_delta_updates` (Aggiornamenti Delta aziendali). Capgo Live Updates Capgo Aggiornamenti in Tempo Reale context: Pagina/Area: Pagina prodotti/aggiornamenti in tempo reale. Ruolo: Etichetta UI breve o elemento di navigazione. Visto in: pagina live-update.astro. Preservare i termini del prodotto/marca e del sviluppatore esattamente. Messaggio chiave `live_update_hero_badge` (Badge eroe Aggiornamento in Tempo Reale). per il flusso di lavoro del prodotto in __CAPGO_KEEP_0__ Aggiornamenti in Tempo Reale, Panoramica dell'aggiornamento in tempo reale per i dettagli di implementazione in Panoramica dell'aggiornamento in tempo reale, per le funzionalità in Funzionalità per i dettagli di implementazione in Features Comportamento dell'aggiornamento per i dettagli di implementazione in Comportamento dell'aggiornamento, e Tipi di Aggiornamento per i dettagli di implementazione in Tipi di Aggiornamento.