Vista general

Utilice la característica de actualizaciones en vivo de Capgo para actualizar los conjuntos de JavaScript de su aplicación de manera 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 para corregir bugs y enviar nuevas características de manera instantánea.

Siempre utilice la última versión de CLI

Siempre ejecute Capgo CLI con @latest por ejemplo npx @capgo/cli@latest. El 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 versión de CLI sigue siendo compatible con cualquier versión del plugin de actualización admitida. Consulte la versión de Capgo.

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, necesitará enviar una nueva compilación binaria nativa 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 se 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 rutas de lanzamiento, como Production, Stagingy Dev.

Cuando subas un nuevo paquete de JS a Capgo y lo asignes a un canal, el Capgo SDK en aplicaciones configuradas para ese canal detectarán la actualización y la descargarán. La próxima vez que se reinicie la aplicación, se cargará el nuevo paquete.

Inicio

Para empezar a utilizar las actualizaciones en vivo, sigue estos pasos:

1. Complete el Capgo Inicio rápido 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 al Capgo SDK que tu aplicación está lista para recibir actualizaciones.

3. Construye tu paquete de 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.

Vea el Implementación de actualizaciones en vivo Guía para obtener más detalles.

La Capgo CLI

La 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 la 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.

¿Qué es la Capgo CLI para?

La Capgo CLI está diseñada para desarrolladores y equipos que necesitan más control y flexibilidad en sus flujos de trabajo de actualizaciones en vivo. Al utilizar la 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
• 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
• Integrar Capgo en sus 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 tus ajustes de 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 Capgo’s 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á incluido 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 encontrados en herramientas de propósito más general CLI

Siguientes Pasos

Canales

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

Reversiones

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

Comportamiento de Actualización

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

Actualizaciones Rápidas

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

Sigue adelante desde Resumen

Si 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 los detalles de implementación en Dispositivos, y Paquetes para los detalles de implementación en Paquetes.