Resumen

Utilice la característica de actualizaciones en vivo de Capgo para actualizar los conjuntos de bundles de JavaScript de su aplicación de forma remota y en tiempo real. Envíe actualizaciones de JS directamente a sus usuarios sin pasar por el proceso de revisión de la tienda de aplicaciones para corregir bugs y enviar nuevas características de inmediato.

Siempre utilice la última versión de CLI

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

Nota

Las actualizaciones en vivo están limitadas a cambios en los conjuntos de bundles de JavaScript. Si necesita actualizar el code nativo, como agregar o eliminar un plugin o cambiar la configuración del proyecto nativo, necesitará enviar un nuevo build binario nativo a las tiendas de aplicaciones.

¿Cómo funcionan las actualizaciones en vivo

El sistema de actualización en vivo de Capgo tiene dos componentes clave:

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

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

Cuando subas una nueva paquetería 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.

Iniciando

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

1. Completa el Capgo Quickstart Configura tu aplicación en Capgo e instala el Capgo SDK.

2. En tu aplicación code, llama a CapacitorUpdater.notifyAppReady() después de que tu aplicación haya finalizado la inicialización. Esto le informa al Capgo SDK que tu aplicación está lista para recibir actualizaciones.

3. Construye tu paquete JS y subelo a Capgo:

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

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

   npx @capgo/cli@latest app debug

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

Ver el Desplegando actualizaciones en vivo Guía para obtener 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 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é 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 actualización en vivo. Al utilizar el CLI en sus pipelines CI/CD, puede:

• Decidir exactamente cuándo realizar actualizaciones y desplegarlas, en lugar de confiar en la automatización integrada de Capgo
• Incorporar sus propios procesos, como la firma de code, la prueba de QA o la aprobación del gerente, entre los pasos de compilación y despliegue
• Integrar Capgo en sus herramientas y flujos de trabajo DevOps existentes

Autenticación

To use the Capgo CLI, you’ll need to authenticate with your API key. You can generate an API key in your Capgo account settings.

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

npx @capgo/cli@latest login [API_KEY]

This command will then be saved for future use. You won’t need to provide your API key with each command after logging in.

Este comando se guardará para futuras referencias. No necesitarás proporcionar tu clave de CLI con cada comando después de iniciar sesión.

If you’re familiar with other live update CLI tools, there are a few key things to note about Capgo’s CLI:

• Si estás familiarizado con otras herramientas de actualización en vivo de Capgo, hay algunas cosas clave que debes tener en cuenta sobre CLI’s Capgo:

• Capgo utiliza un solo CLI para ambos casos de uso de desarrollo y CI/CD, ya que __CAPGO_KEEP_2__ se centra exclusivamente en el conjunto de características de actualización en vivo. @capgo/cli El __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ no requiere un paso de instalación separado. Está incluido en el npx.

• Capgo’s CLI is designed specifically for the live update workflow, so it may not include some features or commands found in more general-purpose CLI tools.

Pasos siguientes

Canales

Descubre cómo usar canales para gestionar diferentes pistas de lanzamiento y dirigir actualizaciones a usuarios específicos.

Reversiones

Descubre cómo revertir a una versión anterior del paquete de JS si una actualización causa problemas.

Comportamiento de actualización

Personaliza cómo y cuándo se descargan y se aplican actualizaciones en tu aplicación.

Actualizaciones rápidas

Descubre cómo usar actualizaciones rápidas para acelerar el proceso de actualización.

Sigue adelante desde Resumen

If estás utilizando Resumen para planificar la consola y las operaciones de API, conecta con API Resumen para obtener detalles de implementación en API Resumen, Introducción para obtener detalles de implementación en Introducción, API Claves para obtener detalles de implementación en API Claves, Dispositivos para obtener detalles de implementación en Dispositivos, y Paquetes para los detalles de implementación en Bundles.