Implementar una Actualización en Vivo

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

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

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

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

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

Si aún no ha completado estos pasos, por favor regrese y complete primero el inicio rápido

Añadir una aplicación Añada una aplicación a su cuenta Capgo e instale el plugin en su aplicación

Subiendo un Paquete

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

1. Compile sus activos web:

   npm run build

2. Suba el paquete a Capgo:

   Consola

   npx @capgo/cli@latest 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@v4
       - uses: actions/setup-node@v4
         with:
           node-version: 18
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Deploy to Capgo
         run: bunx @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 paquete al canal especificado en el comando

Solución de problemas de carga

Si su carga falla, verifique:

• Su ID de aplicación en capacitor.config.ts coincide con su aplicación en el panel de Capgo
• Está ejecutando el comando de carga desde la raíz de su proyecto Capacitor
• Sus activos web están compilados y actualizados

Si aún tiene problemas, vaya a la sección de Solución de problemas

Recibiendo una Actualización en un Dispositivo

Una vez que su paquete esté subido, puede probar la actualización en vivo en un dispositivo:

1. Sincronice su aplicación con el dispositivo:

   npx cap sync ios

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

   npx @capgo/cli@latest app debug

3. Ejecute su aplicación localmente:

   npx cap run ios

   O abra el proyecto iOS/Android en Xcode/Android Studio y realice una ejecución nativa

4. Mantenga 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. Cierre y vuelva a abrir la aplicación. ¡Debería ver su actualización en vivo aplicada!

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

Siguientes Pasos

¡Felicitaciones por implementar su primera actualización en vivo con Capgo! 🎉

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

• Direccionamiento de Actualizaciones con Canales
• Personalización del Comportamiento de Actualización
• Reversiones de Actualizaciones en Vivo