¿Qué es Capacitor-updater?
Capacitor-updater es una tecnología que permite entregar actualizaciones y mejoras de apps a los usuarios finales al instante.
Es ideal para aplicar bug fixes críticos y desplegar cambios al momento sin pasar por la revisión de la App Store.
Es como tener la agilidad de la web para hacer side-loading de actualizaciones en cuanto están listas.
Además, ofrece rollbacks si la nueva actualización provoca un crash en la app
¿Cómo funciona?
Capgo mantiene el bundle de JavaScript de tu app sincronizado con el servidor de Capgo, y cada vez que el usuario abre la app, consulta al servidor de Capgo si hay una nueva actualización disponible para el bundle. Y por supuesto, incluye un montón de configuraciones geniales que te ayudan a afinar la experiencia de tus usuarios.
Uso Capgo en todos los proyectos que desarrollo. Eso me permite dedicar menos tiempo al proceso de revisión de la App Store.
Puedes leer más al respecto aquí.
Entender el versionado semántico con Capgo
Capgo utiliza versionado semántico (semver) para determinar cuándo y cómo aplicar las actualizaciones en tu app. Esto garantiza que tus usuarios solo reciban actualizaciones compatibles y evita que se desplieguen automáticamente cambios que rompan la compatibilidad.
El versionado semántico sigue este formato MAJOR.MINOR.PATCH:
- MAJOR: Cambios incompatibles que requieren publicar una versión nativa en la tienda
- MINOR: Nuevas funciones compatibles con versiones anteriores
- PATCH: Correcciones de errores que son compatibles hacia atrás
Por ejemplo, si tu app está en la versión 1.0.0 y quieres actualizar a 1.0.1 (un patch), Capgo aplicará esta actualización automáticamente. Pero si quieres actualizar desde 1.0.0 a 2.0.0 (una versión major), esto requeriría un lanzamiento nativo en la app store, ya que indica breaking changes.
La configuración de canales de Capgo te permite configurar qué tipos de actualizaciones se aplican automáticamente:
- Estrategia Major: Permite todas las actualizaciones (usar con precaución)
- Estrategia Minor: Solo permite actualizaciones minor y patch
- Estrategia de patch: Solo permite actualizaciones patch
- Estrategia de metadatos: Requiere cumplir con los requisitos de versión mínima
Puedes probar cómo funcionan distintas combinaciones de versiones con la lógica de actualización de Capgo usando nuestra herramienta Semver Tester. Esta herramienta te ayuda a entender exactamente cuándo se aplicarán las actualizaciones según la configuración de tu canal.
¿Hay alguna limitación?
Por muy bien que suene, hay algunas cosas que debemos tener en cuenta. Lo primero es que las actualizaciones OTA solo funcionan con web bundles. Podrías pensar que esto no es una gran limitación porque, en el JS de Capacitor, escribimos casi toda la code en JS, CSS y HTML. Aunque esto sea cierto, todavía hay módulos nativos que instalamos en nuestra app. Si un módulo cambia tus directorios de Android o iOS, no puedes usar OTA para actualizar tu app. Esto se debe a que el contenido de esos directorios se usa para compilar binarios nativos, los cuales OTA no puede actualizar. Ni siquiera una app nativa puede actualizar esta parte.
Pero puedes configurar tu CI/CD para encargarse de esto; hice un tutorial sobre cómo hacerlo aquí para iOS.
Configuración automática de Capgo
¡Es hora de registrarte y obtener tu clave de API para subir tu primera versión! Empieza por crear una cuenta de Capgo.
Una vez que hayas iniciado sesión en Capgo, verás una página de onboarding
Sigue los pasos de la página de onboarding para añadir tu primera app.
Sigue la guía de CLI
Desde la terminal, directamente en la raíz de tu app Capacitor, ejecuta:
npx @capgo/cli@latest init
Para instalar el Capgo en tu app Capacitor, el CLI te guiará en el proceso de configurar tu app con Capgo.
Si prefieres hacerlo manualmente, sigue estos pasos.
Configuración manual de Capgo
Instalar el plugin
Deberías acabar con este code añadido a tu app:
npm i @capgo/capacitor-updater && npx cap sync
Para instalar el plugin en tu app de Capacitor.
Luego, añade este code a tu app para avisar al plugin nativo de que el JS bundle está bien (si no lo haces, el plugin nativo hará rollback a la versión anterior):
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()Esto le indicará al plugin nativo que la instalación fue exitosa.
Luego haz un npm run build && npx cap copy para actualizar tu app.
Inicia sesión en Capgo CLOUD
Primero, usa el all apikey presente en tu cuenta para iniciar sesión con el CLI:
npx @capgo/cli@latest login YOU_KEY
Añade tu primera app
Empecemos creando una app en Capgo Cloud con el CLI.
npx @capgo/cli@latest app add
Este comando usará todas las variables definidas en el archivo de config de Capacitor para crear la app.
Sube tu primera versión
Ejecuta el comando para hacer el build de tu code y enviarlo a Capgo con:
npx @capgo/cli@latest bundle upload
Por defecto, el nombre de la versión será el de tu package.json archivo.
Comprueba en Capgo si el build está presente.
Incluso puedes probarlo con mi app móvil de sandbox.
Establecer canal como predeterminado
Una vez que hayas enviado tu app a Capgo, debes configurar tu canal default para que las apps reciban actualizaciones de Capgo.
npx @capgo/cli@latest channel set production -s default
Recibir un Live Update en un dispositivo
Para que tu aplicación reciba un live update desde Deploy, deberás ejecutar la app en un dispositivo o emulador. La forma más fácil es usar el siguiente comando para lanzar tu app local en un emulador o en un dispositivo conectado a tu ordenador.
npx cap run [ios | android]Abre la app, ponla en segundo plano y ábrela de nuevo; deberías ver en los logs que la app hizo la actualización.
¡Felicidades! 🎉 Has desplegado con éxito tu primer Live Update. Esto es solo el comienzo de lo que puedes hacer con Live Updates. Para saber más, consulta la documentación de Live Updates.
Si necesitas dejar de recibir la actualización en local, ejecuta este comando
npx @capgo/cli@latest channel set
Continúa desde: Actualiza tus apps de Capacitor sin problemas con Capacitor-updater
Si estás usando Actualiza tus apps de Capacitor sin fricciones con Capacitor-updater para planificar la migración y las operaciones enterprise, conéctalo con Capgo Enterprise para el flujo de trabajo del producto en Capgo Enterprise, Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise, Alternativas a Capgo para el flujo de trabajo del producto en Capgo Alternatives, Consultoría de Capgo para el flujo de trabajo del producto en Capgo Consulting, y Soporte Premium de Capgo para el flujo de trabajo del producto en Capgo Premium Support.
