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 ai cambiamenti del bundle JavaScript. Se hai bisogno di aggiornare il nativo code, come aggiungere o rimuovere un plugin o modificare la configurazione del progetto nativo, dovrai inviare un nuovo file binario nativo alle store per l'app.

Come Funzionano gli Aggiornamenti in Tempo Reale

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

1. Capgo SDK, che installi nella tua app. Il SDK controlla gli 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 Production, Staginge Dev.

Quando carichi un nuovo bundle JS su Capgo e lo assegni a un canale, il Capgo SDK nelle app configurate per quel canale rileverà l'aggiornamento e lo scaricherà. La prossima volta che l'app si riavvia, il nuovo bundle verrà caricato.

Avvio

Per iniziare a utilizzare gli Aggiornamenti in Tempo Reale, segui questi passaggi:

1. Completa il Capgo Guida di avvio rapido 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 Live Updates Per ulteriori informazioni, consultare il nostro

The Capgo CLI

The Capgo CLI è uno strumento potente che consente ai developer 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.

Perché serve il Capgo CLI?

Il Capgo CLI è progettato per i developer 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 tuoi 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, la verifica di qualità o le approvazioni del 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 familiarizzato con altri strumenti di aggiornamento live CLI, ci sono alcune cose importanti da notare su Capgo’s CLI:

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

• Lo Capgo CLI non richiede un passo di installazione separato. È integrato con il @capgo/cli package 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.

Continua dall'Overview

Se stai utilizzando Panoramica per pianificare il dashboard e le operazioni di API, connettilo con API Panoramica per i dettagli di implementazione in API Panoramica, Introduzione per i dettagli di implementazione in Introduzione, API Chiavi per i dettagli di implementazione in API Chiavi, Dispositivi per i dettagli di implementazione in Dispositivi Pacchetti per il dettaglio di implementazione in Pacchetti.