Vai al contenuto

Panoramica

Usa la funzionalità Live Updates di Capgo per aggiornare da remoto e in tempo reale i bundle JavaScript della tua app. Invia aggiornamenti JS direttamente ai tuoi utenti senza passare dalla revisione dell'app store, per correggere bug e rilasciare nuove funzionalità all'istante.

Il sistema Live Update di Capgo ha due componenti chiave:

  1. Il SDK Capgo, che installi nella tua app. Il SDK controlla la disponibilità di aggiornamenti e li scarica in background.

  2. I channel, che ti permettono di indirizzare gli aggiornamenti a gruppi specifici di utenti. Puoi usare i channel per gestire diversi release track, come ad esempio Production, Staging, e Dev.

Quando carichi un nuovo bundle JS su Capgo e lo assegni a un channel, il SDK Capgo nelle app configurate per quel channel rileverà l'aggiornamento e lo scaricherà. Al prossimo riavvio dell'app, verrà caricato il nuovo bundle.

Per iniziare a usare Live Updates, segui questi passaggi:

  1. Completa la Quickstart di Capgo per configurare la tua app in Capgo e installare 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 update.

  3. Fai il build del tuo bundle JS e caricalo su Capgo:

    Finestra del terminale
    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:

    Finestra del terminale
    npx @capgo/cli@latest app debug
  5. Una volta scaricato l'update, chiudi e riapri l'app per caricare il nuovo bundle.

Guarda il Deploy di Live Updates guida per maggiori dettagli.

La Capgo CLI è uno strumento potente che permette agli sviluppatori di interagire con i servizi di Capgo direttamente dalle proprie pipeline CI/CD. Con la CLI, hai il controllo granulare su quando le build vengono create e deployate, così puoi integrare Capgo nei tuoi workflow enterprise esistenti.

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 creare le build e deployare gli aggiornamenti, 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

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

Per fare login e salvare in modo sicuro la tua chiave API, esegui:

Finestra del terminale
npx @capgo/cli@latest login [API_KEY]

Questo comando verrà salvato per usarlo in futuro. Dopo il login, non dovrai fornire la tua chiave API a ogni comando.

Differenze principali rispetto ad altri strumenti CLI

Sezione intitolata “Differenze principali rispetto ad altri strumenti CLI”

Se hai familiarità con altri strumenti CLI per live update, ci sono alcuni punti chiave da notare sulla CLI di Capgo:

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

  • La CLI di Capgo non richiede un passaggio di installazione separato. È inclusa nel @capgo/cli pacchetto e può essere eseguito direttamente con npx.

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

Se stai usando Panoramica per pianificare le operazioni della dashboard e di API, collegalo a Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione delle chiavi API, Dispositivi per i dettagli di implementazione in Devices, e Bundle per il dettaglio di implementazione in Bundles.