Resumen

Use Capgo’s Live Updates feature to update the JavaScript bundles of your app remotely, in real-time. Push JS updates directly to your users without going through the app store review process to instantly fix bugs and ship new features.

Siempre utilice la última versión de CLI

Siempre ejecuta Capgo CLI con @latest (por ejemplo npx @capgo/cli@latest). El CLI sigue su propia versión y no no necesita coincidir con la versión mayor de tu plugin o Capacitor. La última CLI se mantiene compatible con cualquier versión del plugin de actualización admitida. Consulte la versión de Capgo.

Nota

Live Updates are limited to JavaScript bundle changes. If you need to update native code, such as adding or removing a plugin or changing native project configuration, you’ll need to submit a new native binary build to the app stores.

¿Cómo funcionan las actualizaciones en vivo?

El sistema de Capgo Live Update tiene dos componentes clave:

1. El Capgo SDK, que instala en tu aplicación. El SDK verifica actualizaciones disponibles y las descarga en segundo plano.

2. Los canales, que te permiten dirigir actualizaciones a grupos específicos de usuarios. Puedes utilizar canales para gestionar diferentes pistas de lanzamiento, como Production, Staging, y Dev.

Cuando subas una nueva paquetería de JS a Capgo y la asignas a un canal, el Capgo SDK en aplicaciones configuradas para ese canal detectará la actualización y la descargará. La próxima vez que se reinicie la aplicación, se cargará la nueva paquetería.

Getting Started

Para empezar a utilizar Actualizaciones en vivo, sigue estos pasos:

1. Completa el Capgo Guía Rápida para configurar tu aplicación en Capgo e instalar el Capgo SDK.

2. En tu aplicación code, llama a CapacitorUpdater.notifyAppReady() después de que tu aplicación haya terminado de inicializarse. Esto le dice a Capgo SDK que tu aplicación está lista para recibir actualizaciones.

3. Construya su paquete de JS y subalo a Capgo:

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

4. Abra su aplicación y espere a que se descargue la actualización. Puede verificar el estado con:

   npx @capgo/cli@latest app debug

5. Una vez descargada la actualización, cierre y vuelva a abrir su aplicación para cargar el nuevo paquete.

Vea el Guía para actualizar en vivo La guía para más detalles.

El Capgo CLI

El Capgo CLI es una herramienta poderosa que permite a los desarrolladores interactuar con los servicios de Capgo desde sus propias pipelines de CI/CD. Con el CLI, tiene control granular sobre cuándo se producen y se despliegan las compilaciones, lo que le permite integrar Capgo en sus flujos de trabajo empresariales existentes.

¿Para qué es 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 utilizar el CLI en sus pipelines de CI/CD, puede:

• Decidir exactamente cuándo construir y desplegar actualizaciones, en lugar de confiar en la automatización incorporada de Capgo
• Inserte sus propios procesos, como la firma de code, pruebas de QA o aprobaciones de gerentes, entre los pasos de compilación y despliegue.
• Integrar Capgo en sus herramientas y flujos de trabajo de DevOps existentes

Autenticación

Para utilizar el Capgo CLI, necesitará autenticarse con su clave de API. Puede generar una clave de API en la configuración de su cuenta de Capgo.

Iniciar sesión y almacenar de manera segura tu clave API ejecutando:

npx @capgo/cli@latest login [API_KEY]

Este comando se guardará para futuras consultas. No necesitará proporcionar su clave API con cada comando después de iniciar sesión.

Diferencias clave con otras herramientas CLI

Si está familiarizado con otras herramientas live update CLI , hay algunas cosas clave que debe tener en cuenta sobre Capgo’s CLI:

• Capgo utiliza un solo CLI para ambos casos de desarrollo y CI/CD, ya que Capgo se centra únicamente en el conjunto de características live update.

• El Capgo CLI no requiere un paso de instalación separado. Está empaquetado con el @capgo/cli paquete y se puede ejecutar directamente utilizando npx.

• Capgo’s CLI está diseñado específicamente para el flujo de trabajo live update , por lo que puede no incluir algunas características o comandos encontrados en herramientas de CLI más generales.

Pasos siguientes

Channels

Aprenda a utilizar canales para gestionar diferentes pistas de lanzamiento y dirigir actualizaciones a usuarios específicos.

Rollbacks

Descubra cómo retroceder a una versión anterior de la caja de JS si una actualización causa problemas.

Comportamiento de la Actualización

Personalice cómo y cuándo se descargan y se aplican actualizaciones en su aplicación.

Actualizaciones Rápidas

Aprende a utilizar actualizaciones rápidas para acelerar el proceso de actualización.

Si está utilizando

Si estás utilizando Overview planificar la consola de dashboard y operaciones API, conectarla con API Resumen para los detalles de implementación en API Resumen Introducción para los detalles de implementación en Introducción API Claves para los detalles de implementación en API Claves Dispositivos para los detalles de implementación en Dispositivos, y Paquetes para los detalles de implementación en Paquetes.