Implementa un Live Update

Usa la funzione Live Updates di Capgo per aggiornare l’interfaccia utente e la logica di business della tua app da remoto, in tempo reale. Invia aggiornamenti del bundle JS direttamente ai tuoi utenti senza passare attraverso l’app store per correggere bug e distribuire nuove funzionalità istantaneamente.

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

1. Installato l’SDK @capgo/capacitor-updater nella tua app Capacitor

2. Configurato l’ID della tua app e il canale di aggiornamento in capacitorconfigts

3. Aggiunto nel tuo codice il metodo CapacitorUpdaternotifyAppReady()

Se non hai ancora completato questi passaggi, torna indietro e completa prima il quickstart

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

Caricamento di un Bundle

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

1. Compila i tuoi asset web:

   npm run build

2. Carica il bundle su Capgo:

   Console

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

   Github Actions

   github/workflows/build_and_deployyml

   name: Build source code and send to Capgo
   
   concurrency:
   group: ${{ githubworkflow }}-${{ githubref }}
   cancel-in-progress: true
   
   on:
   push:
     branches:
       - main
   
   jobs:
   deploy_to_capgo:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
           node-version: 18
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Deploy to Capgo
         run: bunx @capgo/cli@latest bundle upload -a ${{ secretsCAPGO_TOKEN }} --channel ${{ envCHANNEL }}
         env:
           CAPGO_TOKEN: ${{ secretsCAPGO_TOKEN }}

   Gitlab

   // gitlab-ciyml
   stages:
     - build
   
   build:
     stage: build
     image: node:18
     cache:
       - key:
           files:
             - package-lockjson
         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 durante il caricamento

Se il caricamento fallisce, verifica:

• Che l’ID della tua app in capacitorconfigts corrisponda alla tua app nella dashboard di Capgo
• Che stai eseguendo il comando di caricamento dalla root del tuo progetto Capacitor
• Che i tuoi asset web siano compilati e aggiornati

Se continui ad avere problemi, vai alla sezione Risoluzione dei problemi

Ricezione di un aggiornamento su un dispositivo

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

1. Sincronizza la tua app con il dispositivo:

   npx cap sync ios

2. Apri un altro terminale ed esegui il seguente comando per controllare lo stato dell’aggiornamento:

   npx @capgo/cli@latest app debug

3. Esegui la tua app localmente:

   npx cap run ios

   Oppure apri il progetto iOS/Android in Xcode/Android Studio ed esegui un run nativo

4. Mantieni l’app aperta per circa 30 secondi per permettere all’aggiornamento di scaricarsi in background

5. I log impiegheranno alcuni secondi per aggiornarsi e mostrare lo stato dell’aggiornamento

6. Chiudi e riapri l’app. Dovresti vedere l’aggiornamento live applicato!

Torna al Quickstart di Capgo per maggiori dettagli sul test degli aggiornamenti live

Prossimi passi

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

Per saperne di più, consulta il resto della documentazione Live Updates di Capgo. Alcuni argomenti chiave da controllare:

• Targeting degli aggiornamenti con i canali
• Personalizzazione del comportamento degli aggiornamenti
• Rollback degli aggiornamenti live