Gli aggiornamenti Delta

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

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

Questo è particolarmente utile per gli utenti con connessioni di rete più lente o tarificate, poiché riduce l'ammontare di dati che devono essere scaricati.

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 caricate una nuova versione dell'applicazione utilizzando il --delta bandiera, Capgo fa quanto segue:

Ogni file nella tua build viene caricato individualmente
Vengono generate le checksum per ogni file
Viene creato un nuovo manifesto json, elencante tutti i file e le loro checksum
Questo manifesto viene caricato nel database Capgo

Quando un dispositivo che esegue la tua app controlla l'aggiornamento, il plugin Capgo riceve il nuovo manifesto dal server. Lo confronta con quello 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'app combinando questi file scaricati con quelli non modificati che già ha.

Abilita Aggiornamenti Delta (Manifesto)

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

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

Se autoUpdate è impostato su un modello di applicazione istantanea ("atInstall", "onLaunch", o "always") nel tuo capacitor.config, la CLI lo rileva. In ambienti non interattivi invia gli 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 Imporre gli aggiornamenti Delta (Manifesto)

Enforcing Delta (Manifest) Updates

Se desiderate assicurarvi che tutti gli upload siano aggiornamenti Delta (manifesto) e prevenire qualsiasi upload di bundle completo accidentale, potete 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.

Potreste voler utilizzare --delta-only se:

Desiderate sempre utilizzare gli aggiornamenti Delta (manifesto) e non volete mai consentire gli upload di bundle completi
Stavate configurando un flusso di lavoro CI/CD e volete assicurarvi che tutti gli upload automatizzati siano Delta (manifesto)
La vostra app è grande e la banda è limitata, quindi avete bisogno di minimizzare le dimensioni degli upload e dei download

If hai bisogno di eseguire un caricamento bundle completo mentre --delta-only è impostato, basta eseguire il comando di caricamento senza --delta-only. Ciò sovrascriverà la configurazione per quel singolo caricamento, consentendo 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 carichi una nuova versione
Se utilizzi --delta-only, assicurati di non aver dimenticato di includere la --delta flag
Il tuo dispositivo sta eseguendo la versione più recente del plugin Capgo
La tua dispositivo ha una connessione di rete stabile e può raggiungere i server Capgo

Puoi anche utilizzare la Capgo webapp per verificare i dettagli dell'ultima condivisione:

Vai al webapp
Clicca sul tuo app
Clicca sul numero dei bundle della barra delle statistiche.
Scegli l'ultimo bundle
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 condivisioni Delta (manifesto) vengono elaborate correttamente e che i dispositivi ricevono gli aggiornamenti dei manifesti.

È tutto! I --delta il flag indica a Capgo di eseguire le singole upload dei file e la generazione del manifesto necessari per le aggiornamenti Delta (manifest).

Nota che è necessario utilizzare --delta ogni volta che si carica una nuova versione che si desidera essere consegnata come aggiornamento Delta (manifest). Se si omette il flag, Capgo caricherà l'intero bundle JS come un singolo file, e i dispositivi scaricheranno l'intero bundle anche se è cambiato solo una piccola parte.

Continua con gli aggiornamenti Delta

Se si utilizza gli aggiornamenti Delta per pianificare la consegna degli aggiornamenti live, connettilo con Capgo Live Updates per il flusso di lavoro del prodotto in Capgo Live Updates, Panoramica per i dettagli di implementazione in Panoramica, Caratteristiche per il dettaglio di implementazione in Caratteristiche, Comportamento di Aggiornamento per il dettaglio di implementazione in Comportamento di Aggiornamento, e Tipi di Aggiornamento per il dettaglio di implementazione in Tipi di Aggiornamento.