Implementar una Actualización en Vivo

Utiliza la función de Actualizaciones en Vivo de Capgo para actualizar la interfaz de usuario y la lógica de negocio de tu aplicación de forma remota y en tiempo real. Envía actualizaciones de Paquetes JS directamente a tus usuarios sin pasar por la tienda de aplicaciones para corregir errores al instante y lanzar nuevas funciones.

Esta guía asume que has completado el Inicio Rápido de Capgo y ya has:

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

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

3. Añadido en tu código el método CapacitorUpdater.notifyAppReady()

Si aún no has completado estos pasos, por favor regresa y completa primero el inicio rápido.

Añadir una aplicación Añade una aplicación a tu cuenta Capgo e instala el Plugin en tu aplicación

Subir un Paquete

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

1. Compila tus activos web:

   npm run build

2. Sube el Paquete a Capgo:

   Consola

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

   GitHub Actions

   .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 el comando.

Solución de Problemas de Subida

Si tu subida falla, verifica dos veces:

• Tu ID de aplicación en capacitor.config.ts coincide con tu aplicación en el panel de Capgo
• Estás ejecutando el comando de subida desde la raíz de tu proyecto Capacitor
• Tus activos web están compilados y actualizados

Si aún tienes problemas, ve a la sección de Solución de Problemas.

Recibir una Actualización en un Dispositivo

Una vez que tu Paquete está subido, 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 aproximadamente 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!

Consulta el Inicio Rápido de Capgo para más detalles sobre cómo probar actualizaciones en vivo.

Próximos Pasos

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

Para aprender más, revisa el resto de la documentación de Actualizaciones en Vivo de Capgo. Algunos temas clave para revisar a continuación:

• Dirigir Actualizaciones con Canales
• Personalizar Comportamiento de Actualización
• Reversiones de Actualizaciones en Vivo