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. Actualice directamente el paquete JS de su aplicación en los dispositivos de sus usuarios sin pasar por la tienda de aplicaciones para corregir errores y enviar nuevas características de manera instantánea.

Esta guía supone que has completado el Capgo Guía de inicio rápido y ya tienes:

1. Instalado el @capgo/capacitor-updater SDK en tu aplicación de 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 no has realizado esos pasos aún, 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

Subir un paquete

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

1. Construya sus activos web:

   npm run build

2. Suba el paquete a Capgo:

   Consola

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

   Github Acciones

   github/trabajos/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 aún tienes problemas, ve a Resolución de problemas __CAPGO_KEEP_0__.

Recibir 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 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, revise el resto de la Capgo Documentación de Actualizaciones en vivo. Algunos temas clave a revisar a continuación:

• Actualizaciones con Canal
• Personalización del Comportamiento de Actualización
• Actualizaciones en vivo de Revertir