Deploy di un Live Update

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

Tip

Capgo carica la cartella del web build generata. HTML, CSS, JavaScript, asset e modifiche ai pacchetti in puro JavaScript possono essere inviati OTA una volta inclusi nel bundle. Le modifiche a capacitor.config.ts, la configurazione di plugin nativi, i pacchetti nativi o i file di progetto iOS/Android richiedono un Native Build.

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

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

2. Configurato l'app ID e l'update channel in capacitor.config.ts

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

Se non hai ancora fatto questi passaggi, torna indietro e completa prima la quickstart.

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

Upload di un bundle

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

1. Fai la build dei tuoi asset web:

   npm run build

2. Carica il bundle su Capgo:

   Console

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

   Azioni 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 caricherà una nuova versione del bundle nel canale specificato nel comando.

Risoluzione problemi upload

Se l'upload fallisce, ricontrolla:

• Che l'app ID in capacitor.config.ts corrisponda alla tua app nella dashboard Capgo
• che stai eseguendo il comando di upload dalla root del tuo progetto Capacitor
• che i tuoi web assets siano buildati e 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 la tua 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 la tua app localmente:

   npx cap run ios

   Oppure apri il progetto iOS/Android in Xcode/Android Studio e fai un run nativo.

4. Mantieni l'app aperta per circa 30 secondi per permettere all'update di scaricarsi in background.

5. I log impiegheranno qualche secondo per aggiornarsi e mostrare lo stato dell'update.

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

Torna a consultare Quickstart di Capgo per maggiori dettagli sul testing delle Live Update.

Prossimi passi

Complimenti per aver distribuito il tuo primo live update con Capgo! 🎉

Per saperne di più, consulta il resto della documentazione Capgo Live Updates. Ecco alcuni argomenti chiave da approfondire:

• Targeting degli Update con i Channel
• Personalizzare il comportamento degli Update
• Rollback di Live Update

Continua da Deploy a un Live Update

Se stai usando Deploy di un Live Update per pianificare l'automazione CI/CD, connettilo a CI/CD di Capgo per il workflow di 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 Capgo Integrazioni, Integrazione CI/CD per i dettagli implementativi dell'integrazione CI/CD, e Integrazione GitHub Actions per i dettagli implementativi dell'integrazione con GitHub Actions.