Desplegar un Live Update

Usa la función Live Updates de Capgo para actualizar la interfaz y la lógica de negocio de tu app de forma remota y en tiempo real. Publica actualizaciones del bundle JS directamente a tus usuarios sin pasar por la tienda de aplicaciones para corregir errores al instante y lanzar nuevas funciones.

Consejo

Capgo sube la carpeta de build web generada. Los cambios en HTML, CSS, JavaScript, assets y paquetes de JavaScript puro pueden publicarse vía OTA una vez empaquetados allí. Los cambios en capacitor.config.ts, la configuración de plugins nativos, los paquetes nativos o los archivos del proyecto de iOS/Android requieren una versión nativa de la app.

Esta guía asume que has completado el Guía rápida de Capgo y ya tienen:

1. Instalado el @capgo/capacitor-updater SDK en tu app Capacitor

2. Has configurado tu app ID y el canal de actualización en capacitor.config.ts

3. Añadido en tu code el CapacitorUpdater.notifyAppReady() método

Si aún no has completado estos pasos, vuelve atrás y termina primero el quickstart.

Añadir una app Añade una app a tu cuenta de Capgo e instala el plugin en tu app

Subir un bundle

Con el Capgo SDK instalado y configurado, ya puedes subir tu primer bundle de live update:

1. Genera tus web assets:

   npm run build

2. Sube el bundle a Capgo:

   Consola

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

   Acciones de Github

   .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

   Esto subirá una nueva versión del bundle al canal especificado en el comando.

Solución de problemas al subir

Si la subida falla, verifica:

• Que tu app ID en capacitor.config.ts coincida con tu app en el dashboard de Capgo
• Que estés ejecutando el comando de subida desde la raíz de tu proyecto Capacitor
• Que tus assets web estén compilados y actualizados

Si sigues teniendo problemas, ve a la Solución de problemas sección.

Recibir una actualización en un dispositivo

Una vez subido tu bundle, puedes probar live update en un dispositivo:

1. Sincroniza tu app con el dispositivo:

   npx cap sync ios

2. Abre otra terminal y ejecuta el siguiente comando para verificar el estado de la actualización:

   npx @capgo/cli@latest app debug

3. Ejecuta tu app localmente:

   npx cap run ios

   O abre el proyecto de iOS/Android en Xcode/Android Studio y realiza una ejecución nativa.

4. Mantén la app abierta durante unos 30 segundos para permitir que la actualización se descargue en segundo plano.

5. Los logs tardarán unos segundos en actualizarse y mostrar el estado de la actualización.

6. Cierra y vuelve a abrir la app. ¡Deberías ver tu live update aplicada!

Consulta de nuevo la Guía rápida de Capgo para más detalles sobre la prueba de actualizaciones en vivo.

Próximos pasos

¡Felicidades por desplegar tu primera live update con Capgo! 🎉

Para saber más, revisa el resto de la documentación de Capgo Live Updates. Algunos temas clave para explorar a continuación:

• Dirigir actualizaciones con canales
• Personalizar el comportamiento de las actualizaciones
• Reversiones de Live Update

Continúa desde Desplegar un Live Update

Si estás usando Desplegar un Live Update para planificar la automatización de CI/CD, conéctalo con CI/CD de Capgo para el flujo de trabajo del producto en Capgo CI/CD, Native Builds de Capgo para el flujo de trabajo del producto en Capgo Native Builds, Integraciones de Capgo para el flujo de trabajo del producto en Capgo Integraciones, Integración CI/CD para los detalles de implementación de CI/CD Integration, y Integración con GitHub Actions para los detalles de implementación de GitHub Actions Integration.