¿Qué es el actualizador Capacitor?
actualizador de Capacitor, una tecnología que facilita la entrega de actualizaciones y mejoras de aplicaciones a los usuarios de manera instantánea.
Es especialmente genial si deseas realizar correcciones críticas de errores y entregarlos de inmediato sin pasar por las revisiones de la Tienda de Aplicaciones.
Puede pensar en ello como la agilidad "web-like" de la carga lateral de actualizaciones tan pronto como estén disponibles.
Además, proporciona rollback si la actualización nueva hace que la aplicación se estrelle.
¿Cómo funciona?
Capgo mantiene tu paquete de JavaScript de la aplicación sincronizado 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 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: Breaking changes that require a native app store release
- MINOR: Nuevas características que son compatibles hacia atrás
- PATCH: Correcciones 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 (un parche), Capgo aplicará automáticamente esta actualización. Sin embargo, si desea actualizar desde 1.0.0 a 2.0.0 (una versión mayor), esto requeriría una publicación de tienda de aplicaciones nativa, ya que indica cambios de ruptura.
Capgo permite configurar mediante sus ajustes de canal qué tipos de actualizaciones se aplican automáticamente:
- Estrategia de versión mayor: Permite todas las actualizaciones (con precaución)
- Estrategia de versión menor: Permite actualizaciones menores y parches solo
- Estrategia de parche: Solo permite actualizaciones de parches
- 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. Semver TesterEsta herramienta te ayuda a entender exactamente cuándo se aplicarán las actualizaciones según tu configuración de canal.
¿Hay alguna limitación?
As good as it may sound, there are a few things that we need to keep in mind. The first thing is that OTA updates 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.
Pero puedes configurar tu CI/CD para manejar esto, hice un tutorial sobre cómo hacerlo. paquetes web.
Puede pensar que esto no es realmente una gran limitación porque, en Capgo JS, escribimos casi todo __CAPGO_KEEP_1__ en JS, CSS y HTML.
Es hora de registrarse y obtener su clave API para subir su primera versión. Comience por módulos nativos que instalamos en nuestra aplicación, que cambian nuestros directorios Android y iOS, no se pueden actualizar con OTA porque los contenidos de estos directorios se utilizan para compilar binarios nativos, que OTA no puede actualizar, ni siquiera una aplicación nativa puede actualizar esta parte, pero puedes configurar tu CI/CD para manejar esta parte, he hecho un tutorial sobre cómo hacerlo aquí para IOS, Auto Capgo Configuration, es hora de registrarse y obtener su Capgo clave para subir su primera versión, comience registrándose 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 la guía de CLI
Desde una línea de comandos, directamente en la raíz de tu aplicación Capacitor, ejecuta:
npx @capgo/cli@latest init
Para instalar Capgo en tu aplicación Capacitor, 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
Instala 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 JavaScript es saludable (si no lo haces, el plugin nativo se reversionará 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 la 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
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 enviarlo a Capgo con:
npx @capgo/cli@latest bundle upload
Por defecto, el nombre de la versión será el de su package.json archivo.
Verificar en Capgo Si está presente la compilación.
Puede incluso probarlo con mi aplicación de sandbox móvil.
Hacer el canal predeterminado
Después de enviar su aplicación a Capgo, necesita hacer que su canal default hacer 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 su aplicación reciba un live update de Deploy, necesitará 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 su aplicación local en un emulador o un dispositivo conectado a su computadora.
npx cap run [ios | android]Abra la aplicación, póngala en segundo plano y abríla de nuevo, deberías ver en los registros que la aplicación realizó la actualización.
¡Felicidades! Tienes éxito en la implementación de tu primer Live Update. Esto es solo el comienzo de lo que puedes hacer con Actualizaciones en vivo. Para aprender más, consulta la documentación completa de Actualizaciones en vivo. 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 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 Empresa para el flujo de trabajo del producto en Capgo Enterprise, Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternatives 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.
