Deploy a Live Update

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

Suggerimento

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

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

1. Installato il @capgo/capacitor-updater SDK nel tuo progetto Capacitor

2. Configurato il tuo ID app e il canale di aggiornamento in capacitor.config.ts

3. Aggiunto in tuo code il CapacitorUpdater.notifyAppReady() metodo

Se non hai ancora fatto quei passaggi, per favore torna indietro e completa il quickstart prima.

Aggiungi un'app Aggiungi un'app al tuo account Capgo, e installa il plugin nel tuo progetto

Caricamento di 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 Azioni

   github/workflow di costruzione e di distribuzione.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 dell'app in capacitor.config.ts corrisponde al tuo app nel Capgo dashboard
• Stai eseguendo il comando di upload dalla radice del tuo Capacitor progetto
• I tuoi asset web sono costruiti e aggiornati

Se hai ancora dei problemi, vai al Risoluzione dei problemi Sezione.

Ricezione di un Aggiornamento su un Dispositivo

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

1. Sincronizza l'app sul dispositivo:

   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 l'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 aggiornamento live applicato!

Riferisciti a Capgo Guida di avvio rapido 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 del Capgo Aggiornamenti in Tempo Reale documentazione. Alcune delle principali tematiche da verificare successivamente:

• Aggiornamenti in Tempo Reale con canali
• Personalizzazione del comportamento degli aggiornamenti
• Ritorni agli Aggiornamenti in Tempo Reale

Continua da Aggiorna in Tempo Reale

Aggiorna in Tempo Reale per pianificare l'automazione CI/CD, connettilo con __CAPGO_KEEP_0__ CI/CD per il flusso di lavoro del prodotto in Capgo CI/CD for the product workflow 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 il dettaglio di implementazione in Integrazione CI/CD, e GitHub Integrazione azioni per il dettaglio di implementazione in GitHub Integrazione azioni.