What is Capacitor-actualizador?
Capacitor-actualizador, una tecnología que ayuda en la entrega de actualizaciones y mejoras de la aplicación a los usuarios finales de manera instantánea.
Esto es especialmente genial si deseas realizar arreglos críticos de bugs y entregarlos de manera instantánea sin pasar por las revisiones de la Tienda de Aplicaciones.
Puedes pensar en ello como la ‘agilidad web-like’ de la carga de actualizaciones desde el lado en cuanto están disponibles.
Además, proporciona rollback si la nueva actualización hace que la aplicación se estrelle.
¿Cómo funciona?
Capgo mantiene tu paquete de JavaScript de la aplicación en sincronía 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 el paquete. 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. Esto me permite poner menos tiempo en el 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 se desplieguen cambios rotos de manera automática.
La versión semántica sigue el formato MAJOR.MINOR.PATCH:
- MAJOR: Cambios importantes que requieren una actualización de la tienda de aplicaciones nativas
- MINOR: Nuevas características que son compatibles hacia atrás
- PATCH: Correcciones de errores que son compatibles hacia atrás
Por ejemplo, si su aplicación está en la versión 1.0.0 y quiere actualizar a 1.0.1 (una parche), Capgo aplicará automáticamente esta actualización. Sin embargo, si quiere actualizar desde 1.0.0 a 2.0.0 (una versión mayor), esto requeriría una actualización de la tienda de aplicaciones nativas ya que indica cambios importantes.
Capgo’s ajustes de canal permiten configurar qué tipos de actualizaciones se aplican automáticamente:
- Estrategia principal: Permite todas las actualizaciones (utilizar con precaución)
- Estrategia menor: Permite actualizaciones menores y parches solo
- Estrategia parche: Solo permite actualizaciones de parche
- 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 Prueba de Semver. Esta herramienta te ayuda a entender exactamente cuándo se aplicarán las actualizaciones en función de tu 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 solamente funcionan con paquetes web. Puede pensar que esto no es realmente una gran limitación porque, en Capacitor JS, escribimos casi todos los code en JS, CSS y HTML. Mientras que esto puede ser cierto, todavía hay módulos nativos que instalamos en nuestra aplicación. Si un módulo cambia tus directorios Android o iOS, no puedes usar OTA para actualizar tu aplicación. Eso es porque los contenidos de estos directorios se utilizan para compilar binarios nativos, que OTA no puede actualizar. Incluso la aplicación nativa no puede actualizar esta parte.
Pero puedes configurar tu CI/CD para manejar esta parte, hice un tutorial sobre cómo hacerlo aquí para IOS.
Configuración de Auto Capgo
Es hora de registrarse y obtener tu clave API para subir tu primera versión! Comienza por registrándote para una cuenta Capgo.
Una vez que estás conectado a Capgo, tendrás una página de inicio
Sigue los pasos en la página de inicio para agregar tu primera aplicación.
Sigue las CLI directrices
Desde una línea de comandos, directamente en la raíz de tu Capacitor aplicación, ejecuta:
npx @capgo/cli@latest init
Para instalar el Capgo en tu Capacitor aplicación, el CLI te guiará a través del proceso de configuración de tu aplicación con Capgo.
Si deseas hacerlo manualmente, puedes seguir los pasos a continuación.
Configuración manual de Capgo
Instalar el complemento
Deberías terminar con este code agregado a tu aplicación:
npm i @capgo/capacitor-updater && npx cap sync
Para instalar el complemento en tu Capacitor aplicación.
Y luego agrega a tu aplicación este code para notificar al complemento nativo que el paquete de JavaScript está en buen estado (si no lo haces, el complemento nativo se reversionará a la versión anterior):
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()Esto le dirá al complemento nativo que la instalación ha tenido éxito.
Luego haz un npm run build && npx cap copy para actualizar tu aplicación.
Iniciar 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
Agregar su primera aplicación
Comencemos creando una aplicación en Capgo Cloud con el CLI.
npx @capgo/cli@latest app add
Esta orden utilizará todas las variables definidas en el archivo de configuración de Capacitor para crear la aplicación.
Subir su primera versión
Ejecutar la orden para compilar su code y enviarlo a Capgo con:
npx @capgo/cli@latest bundle upload
Por defecto, el nombre de la versión será el que se encuentra en su package.json archivo.
Revisar en Capgo si el build está presente.
Puedes incluso probarlo con mi aplicación móvil de sandbox.
Hacer canal predeterminado
Después de haber enviado tu aplicación a Capgo, necesitas hacer 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 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 Actualizaciones en Vivo. Para aprender más, consulta los documentos completos de Actualizaciones en Vivo.
Si necesita detener la recepción de actualizaciones locales, ejecute este comando
npx @capgo/cli@latest channel set
Siga actualizando sus aplicaciones Capacitor de manera fluida utilizando el Capacitor-actualizador
Si está utilizando Siga actualizando sus aplicaciones Capacitor de manera fluida utilizando el Capacitor-actualizador Para planificar la migración y las operaciones de empresa, conecte con Capgo Empresas Para el flujo de trabajo del producto en Capgo Empresas, Alternativas de Plugin de Empresas de Ionic Para el flujo de trabajo del producto en Alternativas de Plugin de Empresas de Ionic, Alternativas de Capgo Para el flujo de trabajo del producto en Alternativas de Capgo, Consultoría de Capgo para el flujo de trabajo del producto en Capgo Consulting, y Capgo Soporte Premium para el flujo de trabajo del producto en Capgo Soporte Premium.
