Deploya Aggiornamento in Tempo Reale

Utilizza la funzione di aggiornamenti in tempo reale di Capgo per aggiornare l'interfaccia utente e la logica commerciale del tuo app in modo remoto e in tempo reale. Inviare aggiornamenti del pacchetto JS direttamente agli utenti senza passare per la store dell'app per risolvere i bug e spedire nuove funzionalità istantaneamente.

Consiglio

Capgo carica il folder di costruzione web generato. Le modifiche a HTML, CSS, JavaScript, asset e pacchetti di JavaScript puro possono essere inviate OTA una volta che sono bundle 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.

Si presume che tu abbia completato il Capgo Quickstart e hai già:

1. Installato il @capgo/capacitor-updater SDK in your Capacitor app

2. __CAPGO_KEEP_1__ app capacitor.config.ts

3. Added in your code the 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 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 in capacitor.config.ts corrisponde all'app nel 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 Trattamento dei problemi. Ricezione di un Aggiornamento su un Dispositivo

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 questo: Capgo Guida di Avvio Rapido 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 Capgo Documentazione degli Aggiornamenti in Tempo Reale. Alcune delle principali aree da verificare successivamente:

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

Continua da Distribuisci un Aggiornamento in Tempo Reale

Se stai utilizzando Deploy a Live Update 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, Capgo Integrazioni per il flusso di lavoro del prodotto in Capgo Integrazioni, Integrazione CI/CD per i dettagli di implementazione in Integrazione CI/CD, Azioni di integrazione protetta da GitHub per i dettagli di implementazione in Azioni di integrazione protetta da GitHub