Panoramica

Usa la funzione Live Updates di Capgo per aggiornare i bundle JavaScript della tua app da remoto e in tempo reale. Invia aggiornamenti JS direttamente ai tuoi utenti senza passare per la revisione degli store, per correggere bug istantaneamente e rilasciare nuove feature.

Usa sempre l'ultima versione di CLI

Esegui sempre Capgo CLI con @latest (per esempio npx @capgo/cli@latest). CLI segue il proprio versionamento e non non deve necessariamente corrispondere alla major version del tuo plugin o di Capacitor. L'ultima CLI rimane compatibile con qualsiasi versione dei plugin updater supportati. Vedi il versioning di Capgo.

Nota

Le Live Updates sono limitate alle modifiche del bundle JavaScript. Se devi aggiornare il code nativo, come aggiungere o rimuovere un plugin o modificare la configurazione del progetto nativo, dovrai inviare un nuovo Native Build agli app store.

Come funzionano i Live Updates

Il sistema Live Update di Capgo ha due componenti chiave:

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

2. I canali ti permettono di indirizzare gli aggiornamenti a gruppi specifici di utenti. Puoi usarli per gestire diversi track di rilascio, come ad esempio: Production, Staging, e 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à. Al prossimo riavvio dell'app, verrà caricato il nuovo bundle.

Guida rapida

Per iniziare a usare Live Updates, segui questi passaggi:

1. Completa il Capgo Quickstart per configurare la tua app in Capgo e installare il Capgo SDK.

2. Nella tua app code, chiama CapacitorUpdater.notifyAppReady() dopo che l'app ha terminato l'inizializzazione. Questo comunica al Capgo SDK che la tua app è pronta a ricevere gli aggiornamenti.

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

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

4. Apri la tua app e attendi il download dell'update. Puoi controllare lo stato con:

   npx @capgo/cli@latest app debug

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

Vedi la Deploy di Live Updates guida per maggiori dettagli.

Il Capgo CLI

La Capgo CLI è uno strumento potente che permette agli sviluppatori di interagire con i servizi di Capgo direttamente dalle proprie pipeline CI/CD. Grazie alla CLI, hai il controllo granulare su quando i build vengono prodotti e deployati, permettendoti di integrare Capgo nei tuoi workflow enterprise esistenti.

A cosa serve la Capgo CLI?

La Capgo CLI è pensata per sviluppatori e team che vogliono più controllo e flessibilità nei propri workflow live update. Usando la CLI nelle tue pipeline CI/CD, puoi:

• Decidere esattamente quando buildare e deployare gli update, invece di affidarti all'automazione integrata di Capgo
• Inserire i tuoi processi, come la firma code, i test QA o le approvazioni dei manager, tra le fasi di build e deploy
• Integrare Capgo nei tuoi tool e workflow DevOps esistenti

Autenticazione

Per usare la Capgo CLI, dovrai autenticarti con la tua chiave API. Puoi generare una chiave API nelle impostazioni del tuo account Capgo.

To log in and securely store your API key, run:

npx @capgo/cli@latest login [API_KEY]

Questo comando verrà salvato per l'uso futuro. Non dovrai più inserire la tua chiave API ad ogni comando dopo il login.

Differenze chiave rispetto ad altri strumenti CLI

Se conosci altri strumenti CLI live update, ci sono alcune differenze chiave da notare sulla CLI di Capgo:

• Capgo utilizza un unico CLI sia per lo sviluppo che per la CI/CD, poiché Capgo si concentra esclusivamente sul set di funzionalità live update.

• Il CLI di Capgo non richiede un'installazione separata. È incluso nel @capgo/cli package e può essere eseguito direttamente con npx.

• La CLI di Capgo è progettata specificamente per il workflow live update, quindi potrebbe non includere alcune feature o comandi presenti in strumenti CLI più generici.

Prossimi passi

Canali

Scopri come usare i canali per gestire diversi track di rilascio e inviare gli update a utenti specifici.

Rollback

Scopri come fare il rollback a una versione precedente del bundle JS se un aggiornamento causa problemi.

Comportamento degli update

Personalizza come e quando gli aggiornamenti vengono scaricati e applicati nella tua app.

Aggiornamenti rapidi

Scopri come usare i fast updates per velocizzare il processo di aggiornamento.

Continua dalla Panoramica

Se stai usando Panoramica per pianificare dashboard e operazioni API, collegalo a API Panoramica per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, Chiavi API per i dettagli di implementazione in API Keys, Dispositivi per i dettagli di implementazione in Devices, e Bundle per il dettaglio implementativo nei Bundles.