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 pacchetto 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 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 questi passaggi, per favore torna indietro e completa il quickstart prima.

Aggiungi un'app Aggiungi un'app al tuo Capgo account, e installa il plugin nella tua 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 in Capgo:

   Console

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

   Azioni di 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 pacchetto nel canale specificato nella riga di comando.

Risoluzione dei Problemi di Caricamento

Se il tuo caricamento fallisce, controlla:

• Il tuo ID applicazione in capacitor.config.ts corrisponde al tuo applicazione nel dashboard Capgo
• Stai eseguendo la riga di 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 Sezione intitolata “Risoluzione dei Problemi”

Se hai ancora problemi, vai alla sezione "Risoluzione dei Problemi" del tuo dashboard __CAPGO_KEEP_0__.

Una volta caricato il tuo bundle, puoi testare l'aggiornamento live sul 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. Tenere l'app aperta per circa 30 secondi per consentire all'aggiornamento di scaricare in background.

5. Il registro richiederà alcuni secondi per aggiornarsi e mostrare lo stato dell'aggiornamento.

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

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

Esercizi successivi

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

Per imparare di più, revisiona il resto della Capgo Live Updates documentazione. Alcuni argomenti chiave da verificare successivamente:

• Aggiornamenti di destinazione con canali
• Personalizzare il comportamento degli aggiornamenti
• Ritorni degli aggiornamenti in tempo reale

Continua dall'aggiornamento in tempo reale

Se stai utilizzando Aggiornamento in tempo reale per pianificare l'automazione CI/CD, connettilo con Capgo CI/CD per il flusso di lavoro del prodotto in Capgo CI/CD, Capgo Costruzioni native per il flusso di lavoro del prodotto in Capgo Costruzioni native, Integrations di Capgo per il workflow del prodotto in Integrations di Capgo Integrazione CI/CD per il dettaglio di implementazione in Integrazione CI/CD Integrazione di azioni di GitHub per il dettaglio di implementazione in Integrazione di azioni di GitHub