Deploy un Aggiornamento in Tempo Reale

Utilizza il feature 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. Invia aggiornamenti del pacchetto JS direttamente ai tuoi utenti senza passare per la store di app per risolvere bug e rilasciare nuove funzionalità.

Suggerimento

I file del build web generati vengono caricati da Capgo. Le modifiche a HTML, CSS, JavaScript, asset e pacchetti di JavaScript puro possono essere inviate OTA una volta che sono stati bundlati lì. Le modifiche a capacitor.config.tsrichiedono una rilascio dell'applicazione nativa.

Questo guide presuppone 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() Aggiunto nel tuo

__CAPGO_KEEP_0__ il

metodo Se non hai ancora fatto quei passaggi, per favore torna indietro e completa il quickstart prima di procedere con questo guide. Se non hai ancora fatto quei passaggi, per favore torna indietro e completa il quickstart prima di procedere con questo guide. Aggiungi un'applicazione a tuo account Capgo e installa il plugin nel tuo app

Caricare un Bundle

Con il Capgo SDK installato e configurato, sei pronto a caricare il tuo primo pacchetto di aggiornamento live:

1. Costruisci i tuoi asset web:

   npm run build

2. Carica il pacchetto su Capgo:

   Console

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

   Github Actions

   /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 }}

   __CAPGO_KEEP_0__ Azioni

   .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.

Risolvere i problemi di caricamento

Se il tuo caricamento fallisce, controlla:

• Il tuo ID applicazione in capacitor.config.ts corrisponde alla tua applicazione nel Capgo dashboard
• Stai eseguendo il comando di caricamento dalla radice del tuo progetto Capacitor
• I tuoi asset web sono costruiti e aggiornati

If sei ancora in difficoltà, vai al Risoluzione dei Problemi sezione.

Ricezione di un Aggiornamento su un Dispositivo

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

1. Sincronizza l'app sul dispositivo:

   npx cap sync ios

2. Apre una finestra del terminale e esegui il seguente comando per verificare lo stato dell'aggiornamento:

   npx @capgo/cli@latest app debug

3. Avvia l'applicazione localmente:

   npx cap run ios

   O apri il progetto iOS/Android in Xcode/Android Studio e fai un run nativo.

4. Tieni l'applicazione aperta per circa 30 secondi per consentire all'aggiornamento di scaricarsi in background.

5. I log verranno aggiornati dopo alcuni secondi e mostreranno lo stato dell'aggiornamento.

6. Chiudi e riapri l'applicazione. Dovresti vedere l'aggiornamento live applicato!

Riferisciti a: Capgo Guida rapida Per maggiori dettagli sul testing degli aggiornamenti live, consulta la

Passaggi successivi

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

Per imparare di più, revisiona il resto della Capgo Documentazione degli Aggiornamenti Live. Alcune delle principali aree da esplorare sono:

• Targettizzazione degli Aggiornamenti con i Canali
• Personalizzazione del Comportamento degli Aggiornamenti
• Aggiornamenti Live di Ribalto

Continua da Aggiorna in Tempo Reale

Aggiorna in Tempo Reale per pianificare l'automazione CI/CD, connettilo con Se stai utilizzando Aggiorna in Tempo Reale per pianificare l'automazione CI/CD, connettilo con Capgo Integrazione CI/CD per il workflow del prodotto in Capgo Integrazione CI/CD, Capgo Costruzioni Native per il workflow del prodotto in Capgo Costruzioni Native, Capgo Integrazioni per il workflow 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 Integrazione Azioni.