¿Qué es el Capacitor-actualizador?
El Capacitor-actualizador, una tecnología que ayuda en la entrega de actualizaciones y mejoras de aplicaciones a los usuarios finales de manera instantánea.
Esto es especialmente útil si desea realizar correcciones de errores críticos y entregarlas de inmediato sin pasar por las revisiones de la Tienda de Aplicaciones.
Puede pensar en ello como la agilidad 'web-like' de la carga de actualizaciones desde el lado en cuanto estén disponibles.
Además, proporciona deshacer si la nueva actualización hace que la aplicación se estrelle
Cómo funciona?
Capgo mantiene sincronizada la carpeta de JavaScript de tu aplicación con el Capgo servidor, y cada vez que el usuario abre la aplicación, verifica con el Capgo servidor si hay una nueva actualización disponible para la carpeta. Y por supuesto, viene con toneladas de configuraciones geniales que pueden ayudarte a afinar la experiencia del usuario.
Utilizo Capgo en todos mis proyectos que construyo. Eso me permite dedicar menos tiempo al proceso de revisión de la Tienda de Aplicaciones.
Puedes leer más sobre ello aquí.
Entendiendo la versión semántica con Capgo
Capgo utiliza la versión semántica (semver) para determinar cuándo y cómo deben aplicarse las actualizaciones a tu aplicación. Esto garantiza que tus usuarios solo reciban actualizaciones compatibles y evita que los cambios rotos se desplieguen automáticamente.
La versión semántica sigue el formato MAJOR.MINOR.PATCH:
- MAJOR: Cambios importantes que requieren una publicación nativa de la Tienda de Aplicaciones
- MINOR: Nuevas características compatibles con versiones anteriores
- PATCH: Correcciones de errores compatibles con versiones anteriores
Por ejemplo, si tu aplicación está en la versión 1.0.0 y deseas actualizar a 1.0.1 (Capgo), se aplicará automáticamente esta actualización. Sin embargo, si deseas actualizar desde 1.0.0 (__CAPGO_KEEP_0__), (una versión mayor), esto requeriría una publicación nativa en la tienda de aplicaciones, ya que indica cambios disruptivos. 2.0.0 Los ajustes de canal de __CAPGO_KEEP_0__ te permiten configurar qué tipos de actualizaciones se aplican automáticamente:
Capgo’s channel settings allow you to configure which types of updates are automatically applied:
- : Permite todas las actualizaciones (utilizar con precaución) Estrategia de versión menor
- Estrategia de versión menor: Permite actualizaciones menores y parches solo
- Estrategia de parches: Solo permite actualizaciones de parches
- Estrategia de metadatos: Requiere que se cumplan los requisitos de versión mínima
Puedes probar cómo funcionan diferentes combinaciones de versiones con la lógica de actualización de Capgo utilizando nuestra herramienta Semver Tester . Esta herramienta te ayuda a entender exactamente cuándo se aplicarán las actualizaciones según tu configuración de canal.
¿Hay alguna limitación?
Tan bueno como pueda parecer, hay algunas cosas que debemos tener en cuenta. La primera es que las actualizaciones OTA solo funcionan con paquetes web. You may think that this isn’t really a big limitation because, in Capacitor JS, we write almost all code in JS CSS and HTML. While this may be true, there still are native modules that we install to our app. If a module changes your android or iOS directories, you can’t use OTA to update your app. That’s because these directories’ contents are used to compile Native binaries, which OTA can’t update. Even native app cannot update this part.
But puedes configurar tu CI/CD para manejar esta parte, hice un tutorial sobre cómo hacerlo aqui para IOS.
Auto Capgo Configuration
Es hora de registrarse y obtener su clave de API para subir su primera versión. Comienza por registrándose para una cuenta de Capgo.
Una vez que esté conectado a Capgo, tendrá una página de inicio
Sigue los pasos de la página de inicio para agregar su primera aplicación.
Sigue la guía de CLI
Desde una línea de comandos, directamente en la raíz de su aplicación de Capacitor, ejecuta:
npx @capgo/cli@latest init
Para instalar Capgo en su aplicación de Capacitor, CLI le guiará a través del proceso de configurar su aplicación con Capgo.
Si desea hacerlo manualmente, puede seguir los pasos a continuación.
Configuración manual Capgo
Instale el plugin
Deberías terminar con este code agregado a tu aplicación:
npm i @capgo/capacitor-updater && npx cap sync
Para instalar el plugin en tu Capacitor aplicación.
Y luego agrega a tu aplicación este code para notificar al plugin nativo que el paquete de JavaScript es saludable (si no lo haces, el plugin nativo volverá a la versión anterior):
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()Esto le dirá al plugin nativo que la instalación ha tenido éxito.
Luego haz un npm run build && npx cap copy para actualizar tu aplicación.
Inicia sesión en Capgo CLOUD
Primero, utilice la all apikey presente en su cuenta para iniciar sesión con el CLI:
npx @capgo/cli@latest login YOU_KEY
Agrega tu primera aplicación
Comencemos creando una aplicación en Capgo Cloud con el CLI.
npx @capgo/cli@latest app add
Este comando utilizará todas las variables definidas en el archivo de configuración de Capacitor para crear la aplicación.
Sube tu primera versión
Ejecuta el comando para construir tu code y envíalo a Capgo con:
npx @capgo/cli@latest bundle upload
Por defecto, el nombre de la versión será el que se encuentra en tu package.json archivo.
Revisa en Capgo si el build está presente.
Puedes incluso probarlo con mi aplicación de sandbox móvil.
Establecer el canal predeterminado
Después de enviar tu aplicación a Capgo, debes hacer que tu canal default para que las aplicaciones puedan recibir actualizaciones de Capgo.
npx @capgo/cli@latest channel set production -s default
Recibir una actualización en vivo en un dispositivo
Para que tu aplicación reciba una actualización en vivo desde Deploy, necesitarás ejecutar la aplicación en un dispositivo o un emulador. La forma más fácil de hacer esto es simplemente usar el siguiente comando para lanzar tu aplicación local en un emulador o un dispositivo conectado a tu computadora.
npx cap run [ios | android]Abre la aplicación, ponla en segundo plano y abríla de nuevo, deberías ver en los registros que la aplicación realizó la actualización.
Felicidades! 🎉 Has desplegado con éxito tu primera actualización en vivo. Esto es solo el comienzo de lo que puedes hacer con las actualizaciones en vivo. Para aprender más, consulta la documentación completa de Documentación de actualizaciones en vivo.
Si necesitas detener la recepción de actualizaciones locales, ejecuta este comando
npx @capgo/cli@latest channel set
Sigue adelante desde Actualiza tus aplicaciones de Capacitor de manera fluida utilizando el Capacitor-actualizador
Si estás utilizando Actualiza tus aplicaciones de Capacitor de manera fluida utilizando el Capacitor-actualizador para planificar la migración y las operaciones empresariales, conecte con Capgo Empresas para el flujo de trabajo del producto en Capgo Empresas Alternativas de Plugins Empresariales de Ionic para el flujo de trabajo del producto en Alternativas de Plugins Empresariales de Ionic Capgo Alternativas para el flujo de trabajo del producto en Capgo Alternativas Capgo Consultoría para el flujo de trabajo del producto en Capgo Consultoría, y Capgo Soporte Premium para el flujo de trabajo del producto en Capgo Soporte Premium.
