Deploy una 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 tempo reale. Invia aggiornamenti del pacchetto JS direttamente ai tuoi utenti senza passare per la store dell'app per risolvere i bug e distribuire 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 OTA una volta che sono bundle 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 Add an app to your Capgo account, and install the plugin in your app

Caricare 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 su Capgo:

   Console

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

   Github Actions

   github/workflow di costruzione e 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 }}

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

Risoluzione dei problemi delle pubblicazioni

Se la tua pubblicazione fallisce, controlla:

• La tua ID applicazione in capacitor.config.ts corrisponde alla tua applicazione nel dashboard Capgo
• Stai eseguendo il comando di pubblicazione 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 saranno aggiornati dopo alcuni secondi e mostreranno lo stato dell'aggiornamento.

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

Riferisciti al Capgo Quickstart per ulteriori dettagli sul testing degli aggiornamenti live.

Esegui i passaggi successivi

Eccellente! Hai appena distribuito il tuo primo aggiornamento live con Capgo! 🎉

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

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

Continua da Aggiornamento Live di Distribuzione

Se stai utilizzando Aggiornamento Live di Distribuzione per pianificare l'automazione CI/CD, connettilo con Capgo Integrazione CI/CD per il flusso di lavoro del prodotto in Capgo Integrazione 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 Integrazione azioni.