Panoramica

Utilizza la funzione di Aggiornamenti in Tempo Reale di Capgo per aggiornare i bundle JavaScript dell'applicazione in modo remoto e in tempo reale. Inviare aggiornamenti JS direttamente agli utenti senza passare attraverso il processo di revisione dell'app store per risolvere i bug e distribuire nuove funzionalità.

Utilizza sempre la versione più recente di CLI

Esegui sempre Capgo CLI con @latest Esempio npx @capgo/cli@latest. La CLI segue la sua propria versione e non è necessario che corrisponda alla versione maggiore del plugin o alla versione maggiore di Capacitor. La versione più recente di CLI rimane compatibile con qualsiasi versione del plugin di aggiornamento supportata. Vedi la versione di Capgo.

Nota

Live Updates are limited to JavaScript bundle changes. If you need to update native code, such as adding or removing a plugin or changing native project configuration, you’ll need to submit a new native binary build to the app stores.

Come funzionano gli Aggiornamenti in Tempo Reale

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

1. Capgo SDK, che installi nell'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 ad esempio Production, Staginge Dev.

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

Avvio rapido

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

1. Completa il Capgo Guida rapida per configurare il tuo app in Capgo e installare il Capgo SDK.

2. In tuo app code, chiama CapacitorUpdater.notifyAppReady() after tuo app ha finito di inizializzare. Questo avverte il Capgo SDK che il tuo app è pronto a ricevere aggiornamenti.

3. Costruisci il tuo bundle JS e caricalo su Capgo:

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

4. Apre il tuo app e attendi che l'aggiornamento scarichi. Puoi controllare lo stato con:

   npx @capgo/cli@latest app debug

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

Vedi il Deploying Live Updates guida 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. Con la CLI, hai il controllo granulare sulle build che vengono prodotte e distribuite, consentendoti di integrare Capgo nei tuoi flussi di lavoro aziendali esistenti.

Cosa è la 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 la 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, 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 dovrai 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 live CLI, ci sono alcune cose importanti da notare su Capgo’s CLI:

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

• Il Capgo CLI non richiede un passo di installazione separato. È incluso 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 di CLI più general-purpose

Passaggi successivi

Canali

Scopri come utilizzare i canali per gestire diversi percorsi di rilascio e destinare gli aggiornamenti a utenti specifici.

Rollback

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

Comportamento dell'aggiornamento

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

Aggiornamenti veloci

Scopri come utilizzare gli aggiornamenti veloci per accelerare il processo di aggiornamento.

Continua da Panoramica

Se stai utilizzando Panoramica per pianificare dashboard e API operazioni, 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, e Bundle per i dettagli di implementazione in Bundle.