Aggiornamenti Delta

Capgo's sistema di aggiornamento in tempo reale può fornire aggiornamenti più rapidi e efficienti 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é minimizza la quantità 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 che verranno scaricati solo una volta.

How Delta (Manifest) Updates Work

Gli aggiornamenti Delta (manifesto) in Capgo sono gestiti dal plugin Capgo installato nell'app. Quando caricate una nuova versione dell'app utilizzando la --delta Gli aggiornamenti Delta (manifesto) in Capgo fanno le seguenti cose:

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. 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.

Manifesto

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

Abilitare 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", 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. Legacy 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. Legacy directUpdate config viene ancora rilevato. Utilizza --no-delta per forzare l'upload di un bundle completo.

Limitazioni degli aggiornamenti Delta

• File vuoti: I CLI log Ignoring empty file... e esclude i file di zero byte dal manifesto Delta. Non fallisce l'upload, quindi aggiungere un file vuoto può cambiare 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 rimuovere gli spazi prima di caricare un aggiornamento Delta.

Aggiornamenti Delta (Manifesto) obbligatori

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 Se viene utilizzato, Capgo caricherà solo i 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 if:

• 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 effettuare un upload del bundle completo mentre --delta-only è impostato, basta eseguire il comando di upload senza --delta-onlyQuesto sovrascriverà la configurazione per quel singolo caricamento, 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 utilizzi --delta-onlyassicurati 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 del tuo ultimo caricamento:

1. Vai alla web app
2. Clicca sul tuo app
3. Clicca sul numero dei pacchetti della barra delle statistiche.
4. Scegli l'ultimo pacchetto
5. Controlla il Partial campo

Se hai ancora problemi, per favore contatta il supporto Capgo per ulteriore assistenza. Possono verificare i log del server per confermare che le tue upload di Delta (manifesto) stanno essere elaborati correttamente e che i dispositivi stanno ricevendo 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 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 solo una piccola parte è cambiata.

Continua con gli aggiornamenti Delta

Aggiornamenti Delta Area di lavoro: Pagina di prodotto/prezzo aziendale. Ruolo: Etichetta di navigazione breve o elemento UI. Visualizzato in: pagina enterprise.astro. Messaggio chiave `enterprise_delta_updates` (Aggiornamenti Delta aziendali). Per pianificare la consegna degli aggiornamenti in tempo reale, connettilo con Capgo Live Updates for the product workflow in Capgo Live Updates, per il flusso di lavoro del prodotto in Aggiornamenti in Tempo Reale di Capgo, Panoramica per i dettagli di implementazione in Panoramica, Caratteristiche Comportamento dell'aggiornamento per il dettaglio di implementazione in Comportamento dell'aggiornamento, e Tipi di aggiornamento per il dettaglio di implementazione in Tipi di aggiornamento.