Resumen

Usa la función Live Updates de Capgo para actualizar los bundles de JavaScript de tu app de forma remota y en tiempo real. Envía actualizaciones de JS directamente a tus usuarios sin pasar por la revisión de la app store para corregir bugs y lanzar nuevas features al instante.

Usa siempre la última versión de CLI

Ejecuta siempre Capgo CLI con @latest (por ejemplo npx @capgo/cli@latest). CLI sigue su propio versionado y no debe coincidir con la versión major de tu plugin o de Capacitor. La última versión de CLI es compatible con cualquier versión de plugin updater soportada. Ver el versionado de Capgo.

Nota

Los Live Updates se limitan a cambios en el bundle de JavaScript. Si necesitas actualizar el code nativo, como añadir o quitar un plugin o cambiar la configuración del proyecto nativo, deberás enviar un nuevo Native Build a las app stores.

Cómo funcionan los Live Updates

El sistema de Live Update de Capgo tiene dos componentes clave:

1. El SDK de Capgo, que instalas en tu app. El SDK busca actualizaciones disponibles y las descarga en segundo plano.

2. Channels, que te permiten dirigir actualizaciones a grupos específicos de usuarios. Puedes usar channels para gestionar diferentes tracks de lanzamiento, como Production, Staging, y Dev.

Cuando haces upload de un nuevo bundle JS a Capgo y lo asignas a un channel, el SDK de Capgo en las apps configuradas para ese channel detectará la actualización y la descargará. La próxima vez que se reinicie la app, se cargará el nuevo bundle.

Primeros pasos

Para empezar a usar Live Updates, sigue estos pasos:

1. Completa el Quickstart de Capgo para configurar tu app en Capgo e instalar el Capgo SDK.

2. En tu app code, llama a CapacitorUpdater.notifyAppReady() una vez que tu app haya terminado de inicializarse. Esto le indica al Capgo SDK que tu app está lista para recibir actualizaciones.

3. Genera tu JS bundle y súbelo a Capgo:

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

4. Abre tu app y espera a que se descargue la actualización. Puedes consultar el estado con:

   npx @capgo/cli@latest app debug

5. Una vez descargada la actualización, cierra y vuelve a abrir tu app para cargar el nuevo bundle.

Consulta el Desplegando Live Updates guía para más detalles.

El Capgo CLI

El Capgo CLI es una herramienta potente que permite a los devs interactuar con los servicios de Capgo desde sus propios pipelines de CI/CD. Con el CLI, tienes un control granular sobre cuándo se generan y despliegan los builds, permitiéndote integrar Capgo en tus workflows empresariales actuales.

¿Para qué sirve el Capgo CLI?

El Capgo CLI está diseñado para desarrolladores y equipos que necesitan más control y flexibilidad en sus workflows de live update. Al usar el CLI en tus pipelines de CI/CD, puedes:

• Decide exactamente cuándo buildear y desplegar actualizaciones, en lugar de depender de la automatización de Capgo
• Inserta tus propios procesos, como el signing de code, QA testing o aprobaciones de managers, entre el build y el deploy
• Integra Capgo en tus herramientas y workflows de DevOps actuales

Autenticación

Para usar el CLI de Capgo, deberás autenticarte con tu API key. Puedes generar una API key en los settings de tu cuenta de Capgo.

Para loguearte y guardar de forma segura tu API key, ejecuta:

npx @capgo/cli@latest login [API_KEY]

Este comando se guardará para uso futuro. No tendrás que proporcionar tu clave de API en cada comando después de iniciar sesión.

Diferencias clave con otras herramientas de CLI

Si ya conoces otras herramientas de CLI live update, hay algunos puntos clave sobre el CLI de Capgo:

• Capgo utiliza un único CLI tanto para desarrollo como para CI/CD, ya que Capgo se centra solo en el conjunto de funciones de live update.

• El CLI de Capgo no requiere un paso de instalación aparte. Viene incluido en el @capgo/cli package y puedes ejecutarlo directamente usando npx.

• El CLI de Capgo está diseñado específicamente para el workflow de live update, por lo que podría no incluir algunas funciones o comandos de herramientas CLI de propósito general.

Próximos pasos

Canales

Aprende a usar channels para gestionar diferentes tracks de lanzamiento y dirigir actualizaciones a usuarios específicos.

Rollbacks

Descubre cómo hacer un rollback a una versión anterior del JS bundle si una actualización causa problemas.

Comportamiento de actualización

Personaliza cómo y cuándo se descargan y aplican las actualizaciones en tu app.

Actualizaciones rápidas

Aprende a usar fast updates para acelerar el proceso de actualización.

Continúa desde Overview

Si estás usando Resumen para planificar el dashboard y las operaciones de API, conéctalo con Resumen de API para el detalle de implementación en Resumen de API Overview, Introducción para el detalle de implementación en Introducción, Claves de API para los detalles de implementación en las API Keys, Dispositivos para los detalles de implementación en Dispositivos, y Bundles para los detalles de implementación en Bundles.