Deploy a Live Update

Utilizza la funzione di Aggiornamenti in Tempo Reale di Capgo per aggiornare l'interfaccia utente e la logica di business del tuo app in modo remoto e in tempo reale. Aggiorna direttamente il bundle JS dei tuoi utenti senza passare per la store per risolvere i bug e distribuire nuove funzionalità.

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

1. Installato il @capgo/capacitor-updater SDK in your Capacitor app

2. nel tuo capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() Configurato il tuo ID app e il canale di aggiornamento in

Aggiunto nel tuo il metodo

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

Caricamento di un Bundle

Con il Capgo SDK installato e configurato, sei pronto a caricare il tuo primo bundle di aggiornamento live:

1. Costruisci i tuoi asset web:

   npm run build

2. Carica il bundle su Capgo:

   Console

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

   Github Azioni

   github/workflow/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 pacchetto nel canale specificato nel comando.

Risoluzione dei problemi degli upload

Se il tuo upload fallisce, controlla:

• La tua ID dell'app in capacitor.config.ts corrisponde all'app nel Capgo dashboard
• Stai eseguendo il comando di caricamento dalla radice del tuo progetto Capacitor
• I tuoi asset web sono costruiti e aggiornati

Se hai ancora problemi, vai alla sezione " Risoluzione dei problemi" section.

Sezione intitolata “Ricezione di un aggiornamento sul dispositivo”

Sincronizza l'app sul dispositivo:

1. Finestra del terminale

   npx cap sync ios

2. Open another terminal and run the following command to check the update status:

   npx @capgo/cli@latest app debug

3. Esegui il tuo app localmente:

   npx cap run ios

   O apri il progetto iOS/Android in Xcode/Android Studio e esegui una run nativa.

4. Tieni l'app aperta per circa 30 secondi per consentire l'aggiornamento di download in background.

5. I log richiederanno alcuni secondi per aggiornarsi e mostrare lo stato dell'aggiornamento.

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

Riferisciti a il Capgo Quickstart per ulteriori dettagli sul testing degli aggiornamenti live.

Passaggi successivi

Congratulazioni per aver distribuito il tuo primo aggiornamento live con Capgo! 🎉

Per imparare di più, revisiona il resto di Capgo Live Updates documentazione. Alcune delle principali aree da esplorare sono:

• Targetting degli aggiornamenti con canali
• Personalizzazione del comportamento degli aggiornamenti
• Aggiornamenti live con rollback

Continua da Deploy a Live Update

Se stai utilizzando Deploya Aggiornamento in Tempo Reale per pianificare l'automazione CI/CD, connettilo con Capgo Automazione CI/CD per il flusso di lavoro del prodotto in Capgo Automazione CI/CD, Capgo Costruzioni Native per il flusso di lavoro del prodotto in Capgo Costruzioni Native, Capgo Integrazioni per il flusso di lavoro del prodotto in Capgo Integrazioni, Integrazione CI/CD per i dettagli di implementazione in Integrazione CI/CD, e GitHub Integrazione delle Azioni per i dettagli di implementazione in GitHub Integrazione delle Azioni.