Deploy 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. Aggiungi aggiornamenti del pacchetto JS direttamente ai tuoi utenti senza passare per la store dell'app per correggere bug e rilasciare 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 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 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 sul 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 pacchetto nel canale specificato nel comando.

Soluzione dei problemi degli upload

Se il tuo upload fallisce, controlla di nuovo:

• Il tuo ID dell'app capacitor.config.ts corrisponde al tuo app nel Capgo dashboard
• Esegui il comando di upload dal root del tuo progetto Capacitor
• I tuoi asset web sono costruiti e aggiornati

Se hai ancora problemi, vai alla sezione Trattamento dei problemi. section.

Sezione intitolata “Ricezione di un aggiornamento su un dispositivo”

Sincronizza l'app sul dispositivo:

1. Finestra del terminale

   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 il tuo 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 live update applicato!

Riferisciti a Capgo Quickstart per ulteriori informazioni sui test delle aggiornamenti in tempo reale.

Passaggi successivi

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

Per imparare di più, revisiona il resto della documentazione degli aggiornamenti in tempo reale di Capgo. Alcune delle principali aree da verificare successivamente sono:

• Targeting degli aggiornamenti con canali
• Personalizzazione del comportamento degli aggiornamenti
• Ritorni degli aggiornamenti in tempo reale

Continua da Distribuisci un Aggiornamento in Tempo Reale

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