Saltare al contenuto

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.

This is especially beneficial for users on slower or network connections, as it minimizes the amount of data that needs to be downloaded.

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 (Manifesto)

Sezione intitolata “Come Funzionano gli Aggiornamenti Delta (Manifesto)”

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

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

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

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

Copia negli appunti
npx @capgo/cli@latest bundle upload --delta

è impostato su un modello di applicazione istantanea ( autoUpdate , o"atInstall", "onLaunch"o "always"In ambiente non interattivo, __CAPGO_KEEP_0__ invia automaticamente gli aggiornamenti Delta (manifesto) e in ambiente interattivo ti chiede di confermare prima di caricare. Il vecchio "config" viene ancora rilevato. 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. Legacy directUpdate Imporre Aggiornamenti Delta (Manifesto) --no-delta Sezione intitolata “Imporre 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

flag:

Fenestra del terminale --delta-only Copia negli appunti

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

Enforcing Delta (Manifest) Updates --delta-only is used, Capgo will only upload individual files and generate a manifest. Any device that does not support Delta (manifest) updates will not be able to download the update.

You potresti voler usare --delta-only se:

  • Se desideri sempre utilizzare gli aggiornamenti Delta (manifesto) e non desideri mai consentire l'upload completo del bundle
  • 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 eseguire un upload completo del bundle 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

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 il --delta flag ogni volta che carichi una nuova versione
  • Se utilizzi --delta-only, make sure you haven’t accidentally omitted the --delta , assicurati di non aver omesso per errore il
  • Your device is running the latest version of the Capgo plugin
  • 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

  1. Puoi anche utilizzare la __CAPGO_KEEP_0__ webapp per verificare i dettagli della tua ultima caricamento: Vai al
  2. webapp
  3. Clicca sul tuo app
  4. Clicca sul numero dei bundle della barra delle statistiche. Seleziona l'ultimo bundle
  5. Controlla il Partial campo tipo di bundle

Se hai ancora problemi, per favore contatta il supporto Capgo per ulteriore assistenza. Possono controllare i log del server per confermare che le tue upload di Delta (manifesto) 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 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 di Delta (manifesto). Se ometti la bandiera, Capgo caricherà l'intero bundle JS come un singolo file, e i dispositivi scaricheranno l'intero bundle anche se solo una piccola parte è cambiata.

Se stai utilizzando aggiornamenti di Delta per pianificare la consegna di aggiornamenti in tempo reale, connettilo con Capgo Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto in Capgo Aggiornamenti in Tempo Reale, Panoramica per i dettagli di implementazione in Panoramica, Caratteristiche per i dettagli di implementazione in Caratteristiche, 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.