Deploy di un Live Update

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

Tip

Capgo carica la cartella del web build generata. HTML, CSS, JavaScript, asset e modifiche ai package in puro JavaScript possono essere inviati OTA una volta bundlati. Le modifiche a capacitor.config.ts, alla configurazione dei plugin nativi, ai package nativi o ai file di progetto iOS/Android richiedono un nuovo rilascio nativo.

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

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

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

3. Aggiungi il 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

Upload di un Bundle

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

1. Build dei tuoi web assets:

   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 di upload

Se l'upload fallisce, verifica:

• 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 Update 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. 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 dei live updates.

Prossimi passi

Complimenti per aver deployato 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 Channels
• Personalizzare il comportamento degli Update
• Live Update Rollback

Continua con Deploy a un 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.