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 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, che verranno scaricati solo una volta.

Come funzionano gli aggiornamenti Delta (Manifest)

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

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

Quando un dispositivo che esegue l'app verifica 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. Reinsieme la nuova versione dell'app combinando questi file scaricati con quelli non modificati che già ha.

Abilitare Aggiornamenti Delta (Manifesto)

Per abilitare gli aggiornamenti Delta (manifesto) per il tuo Capgo app, 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 automaticamente gli aggiornamenti Delta (manifesto), mentre in ambienti interattivi ti chiede di confermare prima di caricare. Configurazione legacy è ancora rilevata. Utilizza directUpdate Abilitare Aggiornamenti Delta (Manifesto) --no-delta Forzare un caricamento di bundle completo.

Aggiornamenti Delta (Manifesto)

Se desideri assicurarti che tutti i caricamenti siano aggiornamenti Delta (manifesto) e prevenire qualsiasi caricamento 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 i caricamenti 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 eseguire un upload completo del bundle mentre --delta-only è impostato, esegui semplicemente il comando di upload senza --delta-only. Ciò sovrascriverà la impostazione per quell'unico 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 carichi 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:

Vai al webapp
Clicca sul tuo app
Clicca sul numero di bundle della barra delle statistiche.
Seleziona l'ultimo bundle
Verifica il Partial campo

If continui a sperimentare problemi, per favore contatta il supporto Capgo per ulteriore assistenza. Possono verificare i log del server per confermare che le tue upload Delta (manifest) 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 dei manifesti necessari per gli aggiornamenti Delta (manifest).

Nota che devi utilizzare --delta ogni volta che carichi una nuova versione che desideri essere consegnata come aggiornamento Delta (manifest). 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 Delta

Se stai utilizzando gli aggiornamenti Delta per pianificare la consegna degli aggiornamenti in tempo reale, connettili con Capgo Live Updates per il flusso di lavoro del prodotto in Capgo Live Updates, Panoramica __CAPGO_KEEP_0__ per i dettagli di implementazione in Panoramica Caratteristiche __CAPGO_KEEP_0__ per i dettagli di implementazione in Caratteristiche Comportamento dell'aggiornamento __CAPGO_KEEP_0__ per i dettagli di implementazione in Comportamento dell'aggiornamento Tipi di aggiornamento __CAPGO_KEEP_0__ per i dettagli di implementazione in Tipi di aggiornamento