¿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 deseas realizar correcciones de errores críticos y entregarlas de inmediato sin pasar por las revisiones de la Tienda de Aplicaciones.
Puedes pensar en ello como la ‘agilidad web-like’ de la carga de actualizaciones de lado, tan pronto como estén disponibles.
Además, proporciona rollbacks si la nueva actualización hace que la aplicación se caiga
¿Cómo funciona?
Capgo mantiene sincronizada la caja de JavaScript de tu aplicación con el servidor Capgo, y cada vez que el usuario abre la aplicación, verifica con el servidor Capgo si hay una nueva actualización disponible para la caja. 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 actualizaciones a tu aplicación. Esto garantiza que tus usuarios solo reciben actualizaciones compatibles y evita que cambios rotos se desplieguen automáticamente.
La versión semántica sigue el formato MAJOR.MINOR.PATCH:
- MAJOR: Cambios rotos que requieren una liberación nativa de la tienda de aplicaciones
- MINOR: Nuevas características que son compatibles hacia atrás
- PATCH: Arreglos de errores que son compatibles hacia atrás
Por ejemplo, si tu aplicación está en la versión 1.0.0 y deseas actualizar a 1.0.1 (una parche), Capgo aplicará automáticamente esta actualización. Sin embargo, si deseas actualizar desde 1.0.0 a 2.0.0 (una versión mayor), esto requeriría una publicación nativa de la tienda de aplicaciones ya que indica cambios de ruptura.
Capgo’s configuración de canal te permite configurar qué tipos de actualizaciones se aplican automáticamente:
- Estrategia de versión mayor: Permite todas las actualizaciones (utilizar con precaución)
- Estrategia de versión menor: Solo permite actualizaciones de parche
- Estrategia de parche: Solo permite actualizaciones de parche
- Estrategia de metadatos: Requiere que se cumplan los requisitos de versión mínima
Puede probar cómo funcionan diferentes combinaciones de versiones con la lógica de actualización de Capgo utilizando nuestra herramienta de Prueba de Semver. Esta herramienta le ayuda a entender exactamente cuándo se aplicarán las actualizaciones en función de su configuración de canal.
¿Hay alguna limitación?
Como puede parecer, hay algunas cosas que debemos tener en cuenta. La primera es que las actualizaciones OTA. 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.
Pero puedes configurar tu CI/CD para manejar esta parte, hice un tutorial sobre cómo hacerlo aquí para IOS.
Configuración automática de Capgo
Es hora de registrarse y obtener su clave de API para subir su primera versión. Comienza con registrándose en una cuenta de Capgo.
Una vez que esté conectado a Capgo, tendrá una página de onboarding
Sigue los pasos de la página de onboarding 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 del 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 aplicación Capacitor.
Y luego agregue a su aplicación este code para notificar al plugin nativo que el paquete de JS está en buen estado (si no lo hace, 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 haga un npm run build && npx cap copy para actualizar su aplicación.
Inicie sesión en Capgo CLOUD
Primero, utilice el all apikey presente en su cuenta para iniciar sesión con el CLI:
npx @capgo/cli@latest login YOU_KEY
Añade 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 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 la construcción está presente.
Puedes incluso probarlo con mi aplicación de prueba de sandbox móvil.
Establecer canal por defecto
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 pueda recibir 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 abrela 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 los documentos de actualizaciones en vivo.
Si necesitas detener la recepción de actualizaciones locales, ejecuta este comando
npx @capgo/cli@latest channel set
