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. Invia aggiornamenti JS direttamente agli utenti senza dover passare dal processo di revisione dell'app store per correggere bug e rilasciare nuove funzionalità.

Utilizza sempre la versione più recente di CLI

Esegui sempre Capgo CLI con @latest Esempio npx @capgo/cli@latestLa CLI segue la sua propria versioning e non need to match your plugin major or Capacitor major. The latest CLI stays compatible with any supported updater plugin version. See necessario che corrisponda alla versione maggiore del plugin o alla versione maggiore di Capgo. La versione più recente di __CAPGO_KEEP_1__ rimane compatibile con qualsiasi versione del plugin di aggiornamento supportata. Vedi.

Nota

Gli aggiornamenti in tempo reale sono limitati ai cambiamenti del pacchetto 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 app store.

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 nelle app configurate per quel canale rileverà l'aggiornamento e lo scaricherà. La prossima volta che l'app si riavvia, 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 informa 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 si 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 la guida per maggiori dettagli.

La Capgo CLI

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

Di cosa serve la Capgo CLI?

La Capgo CLI è progettata 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 la CLI nei loro flussi di lavoro CI/CD, puoi:

• Decidere esattamente quando costruire e distribuire gli aggiornamenti, anziché affidarti all'automazione integrata di Capgo
• Inserire i tuoi processi, come la firma di code, la verifica di qualità o l'approvazione 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 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 singolo 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 più general-purpose CLI

Passaggi successivi

Canali

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

Ripristini

Scopri come ripristinare 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 nel tuo app.

Aggiornamenti veloci

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

Continua da Panoramica

Se stai utilizzando Panoramica per pianificare il dashboard e le 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 nei dispositivi, e Pacchetti per i dettagli di implementazione nei Pacchetti.