Panoramica

Use Capgo’s Live Updates feature to update the JavaScript bundles of your app remotely, in real-time. Push JS updates directly to your users without going through the app store review process to instantly fix bugs and ship new features.

Note

Le Aggiornamenti in Tempo Reale sono limitati a modifiche al bundle JavaScript. Se hai bisogno di aggiornare il code, ad esempio aggiungendo o rimuovendo un plugin o modificando la configurazione del progetto nativo, dovrai inviare un nuovo file binario nativo alle store di app.

Come Funzionano gli Aggiornamenti in Tempo Reale

Il sistema di Aggiornamenti in Tempo Reale di Capgo ha due componenti chiave:

1. SDK di Capgo, che installi nella tua app. Il SDK controlla le eventuali aggiornamenti disponibili e li scarica in background.

2. Canali, che ti consentono di targetizzare gli aggiornamenti per gruppi specifici di utenti. Puoi utilizzare i canali per gestire diverse tracce di rilascio, come ad esempio ‘alpha’, ‘beta’ e ‘prod’. Production, StagingQuando carichi un nuovo bundle JS su __CAPGO_KEEP_0__ e gli assegni un canale, il __CAPGO_KEEP_1__ __CAPGO_KEEP_2__ nelle app configurate per quel canale rileverà l'aggiornamento e lo scaricherà. La prossima volta che l'app si riavvierà, il nuovo bundle verrà caricato. Dev.

When you upload a new JS bundle to Capgo and assign it to a channel, the Capgo SDK in apps configured for that channel will detect the update and download it. The next time the app restarts, the new bundle will be loaded.

Sottosezione intitolata “Avvio”

Completa il

1. __CAPGO_KEEP_0__ è un nome di prodotto protetto, quindi non è stato tradotto. Capgo Guida rapida per configurare l'app in Capgo e installare il Capgo SDK.

2. Nell'app code, chiamare CapacitorUpdater.notifyAppReady() dopo che l'app ha completato l'inizializzazione. Ciò avverte il Capgo SDK che l'app è pronta a ricevere aggiornamenti.

3. Costruisci il bundle JS e caricalo su Capgo:

   npm run build
   npx @capgo/cli@latest bundle upload --channel=production

4. Apri l'app e attendi che l'aggiornamento venga scaricato. Puoi controllare lo stato con:

   npx @capgo/cli@latest app debug

5. Una volta scaricato l'aggiornamento, chiudi e riapri l'app per caricare il nuovo bundle.

Vedi il Deploying Aggiornamenti in Tempo Reale guide per ulteriori dettagli.

La Capgo CLI

La Capgo CLI è uno strumento potente che consente agli sviluppatori di interagire con i servizi di Capgo dai loro flussi di lavoro CI/CD personalizzati. Con il CLI, hai il controllo granulare sulle build prodotte e distribuite, consentendoti di integrare Capgo nei tuoi flussi di lavoro aziendali esistenti.

Di cosa serve il Capgo CLI?

La Capgo CLI è progettata per gli sviluppatori e le squadre che hanno bisogno di più controllo e flessibilità nei loro flussi di lavoro di aggiornamento in tempo reale. Utilizzando il CLI nei flussi di lavoro CI/CD, puoi:

• Decidere esattamente quando costruire e distribuire gli aggiornamenti, anziché affidarti all'automazione integrata di Capgo
• Inserire i propri processi, come la firma di code, il testing di qualità o le approvazioni dei manager, tra i passaggi di costruzione e distribuzione
• Integrare Capgo nei tuoi strumenti e flussi di lavoro DevOps esistenti

Autenticazione

Per utilizzare il Capgo CLI, avrai bisogno di autenticarti con la tua chiave API. Puoi generare una chiave API nelle impostazioni del tuo account Capgo.

Per accedere e memorizzare in modo sicuro la tua chiave API, esegui:

npx @capgo/cli@latest login [API_KEY]

Questo comando verrà poi salvato per future utilizzazioni. Non avrai bisogno di fornire la tua chiave API con ogni comando dopo l'accesso.

Differenze chiave rispetto ad altri strumenti CLI

Se sei già familiarizzato con altri strumenti di aggiornamento in tempo reale CLI, ci sono alcune cose importanti da notare su Capgo’s CLI:

• Il Capgo CLI utilizza un solo CLI per entrambi i casi di utilizzo di sviluppo e CI/CD, poiché Capgo è focalizzato esclusivamente sul set di funzionalità di aggiornamento in tempo reale.

• Il Capgo CLI non richiede un passo di installazione separato. È integrato con il @capgo/cli pacchetto e può essere eseguito direttamente utilizzando npx.

• Capgo’s CLI è progettato specificamente per il flusso di lavoro di aggiornamento in tempo reale, quindi potrebbe non includere alcune funzionalità o comandi trovati in strumenti CLI più general-purpose.

Passaggi successivi

Canali

Impara a utilizzare i canali per gestire diverse tracce di rilascio e destinare gli aggiornamenti a utenti specifici.

Rollback

Scopri come tornare a una versione precedente del bundle JS se un aggiornamento causa problemi.

Comportamento dell'aggiornamento

Personalizza come e quando gli aggiornamenti vengono scaricati e applicati nell'app.

Aggiornamenti veloci

Impara a utilizzare gli aggiornamenti veloci per accelerare il processo di aggiornamento.