Deploy di un Live Update

Usa la funzione Live Updates di Capgo per aggiornare l'UI e la logica di business della tua app da remoto, in tempo reale. Invia gli aggiornamenti del bundle JS direttamente ai tuoi utenti senza passare dagli app store, per correggere bug e rilasciare nuove funzionalità all'istante.

Tip

Capgo carica la cartella di build web generata. Le modifiche a HTML, CSS, JavaScript, asset e pacchetti in puro JavaScript possono essere distribuite via OTA una volta incluse lì. Le modifiche a capacitor.config.ts, configurazione dei plugin nativi, pacchetti nativi o file di progetto iOS/Android richiedono un rilascio dell'app nativa.

Questa guida presuppone che tu abbia completato la Quickstart di Capgo e disponete già di:

1. Installato il @capgo/capacitor-updater SDK nella tua app Capacitor

2. Configurato l'app ID e il canale di aggiornamento in capacitor.config.ts

3. Aggiunto nel tuo code il CapacitorUpdater.notifyAppReady() metodo

Se non hai ancora completato questi passaggi, torna indietro e finisci prima il quickstart.

Aggiungi un'app Aggiungi un'app al tuo account Capgo e installa il plugin nella tua app

Caricamento di un bundle

Con Capgo SDK installato e configurato, sei pronto per caricare il tuo primo bundle live update:

1. Fai il build dei tuoi asset web:

   npm run build

2. Carica il bundle su Capgo:

   Console

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

   Azioni di Github

   .github/workflows/build_and_deploy.yml

   name: Build source code and send to Capgo
   
   concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
   
   on:
   push:
     branches:
       - main
   
   jobs:
   deploy_to_capgo:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
           node-version: '24'
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Deploy to Capgo
         run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} --channel ${{ env.CHANNEL }}
         env:
           CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

   Gitlab

   .gitlab-ci.yml

   stages:
     - build
   
   build:
     stage: build
     image: node:18
     cache:
       - key:
           files:
             - package-lock.json
         paths:
           - .node_modules/
     script:
       - npm install
       - npm run build
       - npx @capgo/cli@latest bundle upload -a $CAPGO_TOKEN --channel $CAPGO_CHANNEL
     artifacts:
       paths:
         - node_modules/
         - dist/
     only:
       - master

   Questo comando carica una nuova versione del bundle nel canale specificato.

Risoluzione dei problemi di upload

Se il caricamento fallisce, verifica:

• L'ID della tua app in capacitor.config.ts corrisponde alla tua app nella dashboard di Capgo
• Stai eseguendo il comando di upload dalla radice del tuo progetto Capacitor
• I tuoi asset web sono stati buildati e sono aggiornati

Se hai ancora problemi, vai alla Risoluzione problemi sezione.

Ricevere un aggiornamento su un dispositivo

Una volta caricato il bundle, puoi testare live update su un dispositivo:

1. Sincronizza l'app sul dispositivo:

   npx cap sync ios

2. Apri un altro terminale ed esegui questo comando per controllare lo stato dell'update:

   npx @capgo/cli@latest app debug

3. Avvia l'app localmente:

   npx cap run ios

   Oppure apri il progetto iOS/Android in Xcode/Android Studio ed esegui un run nativo.

4. Mantieni l'app aperta per circa 30 secondi per permettere il download dell'update in background.

5. Gli logs impiegheranno qualche secondo ad aggiornarsi e a mostrare lo stato dell'update.

6. Chiudi e riapri l'app. Dovresti vedere il tuo live update applicato!

Fai riferimento a Quickstart di Capgo per maggiori dettagli sul test delle live updates.

Prossimi passi

Congratulazioni per aver deployato il tuo primo live update con Capgo! 🎉

Per saperne di più, consulta il resto della documentazione di Capgo Live Updates. Alcuni argomenti chiave da esplorare:

• Targeting degli aggiornamenti con i canali
• Personalizzazione del comportamento degli aggiornamenti
• Rollback di Live Update

Continua da Deploy di Live Update

Se stai usando Deploy di un Live Update per pianificare l'automazione CI/CD e connetterla a CI/CD con Capgo per il workflow del prodotto in Capgo CI/CD, Capgo Native Build per il workflow di prodotto in Capgo Native Builds, Integrazioni Capgo per il workflow di prodotto in Integrazioni Capgo, Integrazione CI/CD per i dettagli implementativi in CI/CD Integration, e Integrazione GitHub Actions per i dettagli implementativi in GitHub Actions Integration.