¿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 de la web' de actualizaciones de carga lateral tan pronto como estén disponibles.
Además, proporciona rollback si la nueva actualización hace que la aplicación se estrelle
¿Cómo funciona?
Capgo keeps your app’s JavaScript bundle in sync with the Capgo server, and every time the user opens the app, it checks with the Capgo server if a new update is available to the bundle. And of course, it comes with tons of awesome configurations which can help you fine-tune your user’s experience.
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 reciban actualizaciones compatibles y evita que se desplieguen cambios que rompen automáticamente.
La versión semántica sigue el formato MAJOR.MINOR.PATCH:
- MAJOR: Cambios 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 de una tienda de aplicaciones nativa 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: Permite actualizaciones menores y parches solo
- Estrategia de 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 de prueba de Semver Herramienta de 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 pueda parecer, hay algunas cosas que debemos tener en cuenta. La primera cosa 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.
. Puedes pensar que esto no es realmente una gran limitación porque, en __CAPGO_KEEP_1__ JS, escribimos casi todos los __CAPGO_KEEP_0__ en JS, CSS y HTML. Mientras que esto puede ser cierto, todavía hay módulos nativos que instalamos en nuestra aplicación..
Configuración automática de Capgo
Es hora de registrarse y obtener su clave de API para subir su primera versión. Comience por registrándose en una cuenta de Capgo.
Una vez que esté conectado a Capgo, tendrá una página de incorporación
Siga los pasos de la página de incorporación para agregar su primera aplicación.
Siga la guía de CLI
Desde una línea de comandos, directamente en la raíz de su aplicación de Capacitor, ejecute:
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 de 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 agrega a tu aplicación este code para notificar al plugin nativo que el paquete de JS está en buen estado (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, utiliza el all apikey presente en tu cuenta para iniciar sesión con el CLI:
npx @capgo/cli@latest login YOU_KEY
Agrega tu primera aplicación
Vamos a empezar 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.
Subir tu primera versión
Ejecuta el comando para construir tu 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 tu package.json archivo.
Revisa en Capgo si la construcción está presente.
Puedes incluso probarlo con mi aplicación de prueba de escritorio Establecer canal por defecto.
Después de haber enviado tu aplicación a __CAPGO_KEEP_0__, necesitas establecer tu canal
After you have sent your app to Capgo, you need to make your channel default To permit que las aplicaciones reciban 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 utilizar 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 la documentación completa sobre 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 con la actualización de tus aplicaciones Capacitor de manera fluida utilizando el Capacitor-actualizador
Si estás utilizando Actualiza tus aplicaciones Capacitor de manera fluida utilizando el Capacitor-actualizador para planificar la migración y las operaciones de empresa, conecta con Capgo Enterprise para el flujo de trabajo del producto en Capgo Enterprise, Alternativas del plugin de Ionic Enterprise para el flujo de trabajo del producto en Alternativas del plugin de Ionic Enterprise, 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.
