Resumen

Utilice la característica de actualizaciones en vivo de Capgo para actualizar los paquetes de JavaScript de tu aplicación de manera remota y en tiempo real. Envía actualizaciones de JS directamente a tus usuarios sin pasar por el proceso de revisión de la tienda de aplicaciones para corregir errores y enviar nuevas características de inmediato.

Nota

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

Cómo funcionan las Actualizaciones en Vivo

El sistema de actualizaciones en vivo de Capgo 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 los canales para gestionar diferentes rutas de lanzamiento, como Production, Stagingy Dev.

Cuando subas un nuevo paquete JS a Capgo y lo asignes 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á el nuevo paquete.

Iniciar

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

1. Complete el Capgo Guía rápida para configurar tu aplicación en Capgo y 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 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, cierre y vuelva a abrir su aplicación para cargar el nuevo paquete.

Consulte 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 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 actualizaciones en vivo. 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 integrada de Capgo
• Insertar sus propios procesos, como la firma de code, la prueba de QA o la aprobación del gerente, entre los pasos de construcción y despliegue
• Integra Capgo en tus herramientas y flujos de trabajo de DevOps existentes

Autenticación

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

Para iniciar sesión y almacenar de manera segura tu clave de API, ejecuta:

npx @capgo/cli@latest login [API_KEY]

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

Diferencias clave con otras herramientas de CLI

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

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

• 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 de actualización en vivo, por lo que puede no incluir algunas características o comandos que se encuentran en herramientas de CLI más generales.

Pasos siguientes

Canales

Aprende a utilizar 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

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

Siga adelante desde Resumen

Si está utilizando Resumen para planificar la consola y las operaciones de API, conecte 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 el detalle de implementación en Dispositivos, y Paquetes para el detalle de implementación en Paquetes.