Distribuisci un Aggiornamento in Tempo Reale

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 in your Capacitor app

2. nella tua app capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() Aggiunto il

__CAPGO_KEEP_0__

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/compila_e_distribuisci.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 upload fallisce, controlla:

• Il tuo ID applicazione in capacitor.config.ts corrisponde al tuo app in il Capgo dashboard
• Stai eseguendo il comando di upload 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 "Ricezione di un aggiornamento su un dispositivo"

Una volta caricato il tuo bundle, puoi testare l'aggiornamento live su un dispositivo:

Finestra del terminale

1. Copia negli appunti

   npx cap sync ios

2. Apri un'altra finestra del terminale e esegui il seguente comando per controllare lo stato dell'aggiornamento:

   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 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 live 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 documentation. Alcune delle principali aree da esplorare sono:

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