Desplegar una actualización en vivo

Utilice la característica de actualizaciones en vivo de Capgo para actualizar la interfaz de usuario y la lógica de negocio de su aplicación de manera remota y en tiempo real. Envíe actualizaciones del paquete JS directamente a sus usuarios sin pasar por la tienda de aplicaciones para corregir bugs y enviar nuevas características de inmediato.

Consejo

Capgo sube el carpeta de compilación web generada. Los cambios en HTML, CSS, JavaScript, activos y paquetes de JavaScript puros pueden ir OTA una vez que estén empaquetados allí. Los cambios en capacitor.config.ts, la configuración de plugin nativo, paquetes nativos o archivos de proyecto iOS/Android requieren una publicación de aplicación nativa.

Esta guía supone que has completado el Capgo Inicio rápido y ya has hecho:

1. Instalado el @capgo/capacitor-updater SDK en tu aplicación Capacitor

2. Configurado tu ID de aplicación y canal de actualizaciones en capacitor.config.ts

3. Agregado en tu code el CapacitorUpdater.notifyAppReady() método

Si aún no has realizado esos pasos, por favor vuelve atrás y completa el inicio rápido primero.

Agregar una aplicación Agregar una aplicación a tu cuenta de Capgo, y instalar el plugin en tu aplicación

Subiendo un paquete

With el Capgo SDK instalado y configurado, estás listo para subir tu primer paquete de actualización en vivo:

1. Construye tus activos web:

   npm run build

2. Sube el paquete a Capgo:

   Consola

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

   Github Acciones

   .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 de paquete al canal especificado en la orden.

Resolución de problemas de carga

Si tu carga falla, revisa:

• Tu ID de aplicación en capacitor.config.ts coincide con tu aplicación en la consola de Capgo
• Estás ejecutando la orden de carga desde la raíz de tu proyecto Capacitor
• Tus activos web están construidos y actualizados

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

Recibiendo una Actualización en un Dispositivo

Una vez que subas tu paquete, puedes probar la actualización en vivo en un dispositivo:

1. Sincroniza tu aplicación con el dispositivo:

   npx cap sync ios

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

   npx @capgo/cli@latest app debug

3. Ejecuta tu aplicación localmente:

   npx cap run ios

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

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

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

6. Cierra y vuelve a abrir la aplicación. Deberías ver tu actualización en vivo aplicada!

Vuelve a consultar el Capgo Quickstart para obtener más detalles sobre la prueba de actualizaciones en vivo.

Pasos siguientes

¡Felicidades por desplegar tu primera actualización en vivo con Capgo! 🎉

Para obtener más información, revisa el resto de la Capgo Actualizaciones en vivo documentaciónAlgunos temas clave para revisar a continuación:

• Actualizaciones en vivo con canales
• Personalizando el comportamiento de la actualización
• Actualizaciones en vivo de retroceso

Sigue adelante desde Desplegar una Actualización en vivo

Si estás utilizando Desplegar una Actualización en vivo para planificar la automatización de CI/CD, conecta con Capgo CI/CD para el flujo de trabajo del producto en Capgo CI/CD, Edición nativa de Capgo para el flujo de trabajo del producto en Edición nativa de Capgo, Integraciones de Capgo para el flujo de trabajo del producto en Integraciones de Capgo, Integración CI/CD para el detalle de implementación en Integración CI/CD, y GitHub Integración de Acciones para el detalle de implementación en GitHub Integración de Acciones.