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. Publica actualizaciones de JS directamente a tus usuarios sin pasar por el proceso de revisión de la app store para corregir errores al instante y lanzar nuevas funciones.

Usa siempre la última versión de CLI

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

Nota

Live Updates está limitado a cambios en el bundle de JavaScript. Si necesitas actualizar el code nativo, como añadir o eliminar un plugin o cambiar la configuración del proyecto nativo, deberás enviar una nueva compilación binaria nativa a las tiendas de aplicaciones.

Cómo funcionan las Live Updates

El sistema 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 distintos tracks de lanzamiento, como Production, Staging, y Dev.

Cuando subes un nuevo bundle de 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 la Guía rápida de Capgo para configurar tu app en Capgo e instalar el Capgo SDK.

2. En tu app code, llama a CapacitorUpdater.notifyAppReady() después de que la app termine 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 la Desplegar Live Updates guía para más detalles.

El Capgo CLI

El Capgo CLI es una herramienta potente que permite a los desarrolladores 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 flujos de trabajo empresariales existentes.

¿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 flujos de trabajo de live update. Al usar el CLI en tus pipelines de CI/CD, puedes:

• Decidir exactamente cuándo hacer build y desplegar actualizaciones, en lugar de depender de la automatización integrada de Capgo
• Inserta tus propios procesos, como la firma de code, pruebas de QA o aprobaciones de managers, entre los pasos de build y deploy
• Integrar Capgo en tus herramientas y flujos de trabajo de DevOps existentes

Autenticación

Para usar el Capgo CLI, necesitarás autenticarte con tu clave de API. Puedes generar una clave API en la configuración de tu cuenta de Capgo.

To log in and securely store your API key, run:

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 CLI

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

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

• El CLI de Capgo no requiere una instalación aparte. Viene incluido en el @capgo/cli paquete y se puede ejecutar 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 distintos tracks de lanzamiento y dirigir actualizaciones a usuarios específicos.

Reversiones

Descubre cómo hacer rollback a una versión anterior del bundle JS 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 las actualizaciones rápidas para acelerar el proceso de actualización.

Continuar desde Overview

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