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. Invia aggiornamenti del pacchetto JS direttamente ai tuoi utenti senza passare per la store dell'app per risolvere i bug e distribuire nuove funzionalità.

Suggerimento

Capgo carica il cartellino di costruzione web generato. Le modifiche a HTML, CSS, JavaScript, asset e pacchetti di JavaScript puro possono essere inviate via OTA una volta che sono stati riuniti lì. Le modifiche a capacitor.config.ts, la configurazione dei plugin nativi, i pacchetti nativi o i file dei progetti iOS/Android richiedono una rilascio dell'app nativa.

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

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 in il 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 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/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 dei problemi degli upload

Se il tuo caricamento fallisce, controlla:

• Il tuo ID applicazione in capacitor.config.ts corrisponde con l'applicazione nel tuo Capgo dashboard
• Stai eseguendo il 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 Ricevere un Aggiornamento su un Dispositivo

Sezione intitolata “Ricevere un Aggiornamento su un Dispositivo”

Ricevere un Aggiornamento su un Dispositivo

1. Sincronizza l'app sul dispositivo:

   npx cap sync ios

2. Apri un'altra 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. I log richiederanno alcuni secondi per aggiornarsi e mostrare lo stato dell'aggiornamento.

6. Chiudi e riapri l'app. Dovresti vedere il tuo aggiornamento in tempo reale applicato!

Riferisciti a Capgo Guida di Avvio Rapido per ulteriori informazioni sul testing degli aggiornamenti in tempo reale.

Passaggi Successivi

Congratulazioni per aver distribuito il tuo primo aggiornamento in tempo reale con Capgo! 🎉

Per imparare di più, revisiona il resto della Capgo Documentazione degli Aggiornamenti in Tempo Reale. Alcune delle principali aree da verificare successivamente sono:

• Targettizzazione degli Aggiornamenti con Canali
• Personalizzazione del Comportamento degli Aggiornamenti
• Aggiornamenti in Tempo Reale con Annullamento

Continua dall'Aggiornamento in Tempo Reale

Se stai utilizzando 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 Azioni di integrazione per i dettagli di implementazione in GitHub Azioni di integrazione.