Deployare un Live Update

Utilizza il feature 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. Invia aggiornamenti del pacchetto JS direttamente ai tuoi utenti senza passare per la store di app per risolvere bug e rilasciare nuove funzionalità.

Tip

Capgo carica il cartello di costruzione web generato. Le modifiche a HTML, CSS, JavaScript, asset e pacchetti di JavaScript puri possono essere inviate OTA una volta che sono bundle lì. Le modifiche a capacitor.config.tsPer native plugin di configurazione, pacchetti nativi o file progetto iOS/Android, è necessario un rilascio di app nativa.

Questa guida presuppone che tu abbia completato il Capgo Guida rapida and have already:

1. Installato il @capgo/capacitor-updater SDK nel tuo Capacitor app

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

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

Se non hai ancora eseguito quei passaggi, per favore torna indietro e completa il quickstart prima.

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

Caricamento di un Bundle

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

1. Costruisci i tuoi asset web:

   npm run build

2. Carica il bundle in Capgo:

   Console

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

   Github Azioni

   github/workflow di costruzione e distribuzione.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.

Risolvere i Problemi di Caricamento

Se il tuo caricamento fallisce, controlla:

• La tua ID applicazione in capacitor.config.ts corrisponde alla tua applicazione nel Capgo dashboard
• Sei in esecuzione del comando di caricamento dalla radice del tuo Capacitor progetto
• I tuoi asset web sono costruiti e aggiornati

Se hai ancora problemi, vai alla sezione Risolvere i Problemi section.

Ricezione di un Aggiornamento su un Dispositivo

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

1. Sincronizza l'app sul dispositivo:

   npx cap sync ios

2. Apre una finestra del terminale e esegui il seguente comando per verificare lo stato dell'aggiornamento:

   npx @capgo/cli@latest app debug

3. Esegui l'app localmente:

   npx cap run ios

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

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

5. Le log saranno aggiornati in pochi secondi e mostreranno lo stato dell'aggiornamento.

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

Riferisciti a Capgo Guida rapida for more details on testing live updates.

Next Steps

Congrats on deploying your first live update with Capgo! 🎉

Per imparare di più, rivedi il resto del contenuto. Capgo Live Updates documentation__CAPGO_KEEP_0__ Live Updates documentation

• . Alcuni argomenti chiave da verificare successivamente sono:
• Personalizzare il comportamento dell'aggiornamento
• Live Update Ritorni

Continua da Deploy un Live Update

Se stai utilizzando Deploy un Live Update per pianificare l'automazione CI/CD, connettilo con Capgo CI/CD per il flusso di lavoro del prodotto in Capgo CI/CD, Capgo Costruzioni nativa per il flusso di lavoro del prodotto in Capgo Costruzioni nativa, Capgo Integrazioni per il workflow del prodotto in Capgo Integrazioni, Integrazione CI/CD per i dettagli di implementazione nella integrazione CI/CD, e GitHub Actions Integration per i dettagli di implementazione in GitHub Azioni di integrazione.