Capgo utiliza 2 variables principales para gestionar las versiones en tu aplicación Capacitor:
- Versión nativa
- Versión de JavaScript
Todas las opciones de versión se deciden en el lado del servidor por Capgo.
Sistema de versionado
Para gestionar la versión Capgo utilice el sistema SemVer. Consulte la especificación SemVer o verifique la compatibilidad de actualización de Capgo con el Semver Tester.
Versiones
¿Dónde Capgo encuentra la versión para comparar?
Puede sobrescribir este comportamiento estableciendo la clave de versión en el
capacitor.config.jsonarchivo los documentos aquí La versión nativa se ignorará para todas las plataformas.
IOS
En IOS, la var se establece en tu proyecto aquí ios/App/App/Info.plist bajo la claveCFBundleShortVersionString o ios/App/App.xcodeproj/project.pbxproj o MARKETING_VERSION bajo la clave MARKETING_VERSION si Info.plist se estableció en tu
archivo.
Android android/app/build.gradle En Android, la var se establece en tu proyecto aquí defaultConfig.versionName
JavaScript ( Capgo bundle version )
In JavaScript, el var se puede configurar en tu package.json bajo la clave version
De lo contrario, necesitarás proporcionarlo en el comando de carga.
Comportamiento predeterminado
Esto es cómo el canal Capgo se comportará si no cambias ninguna configuración.
Este comportamiento se basará en el canal único que has establecido como predeterminado.
Cuando se realiza una instalación fresca de tu aplicación Capacitor
Cuando el usuario descargue tu aplicación Ionic por primera vez y abra la aplicación, se contactará con el servidor Capgo.
Actualmente, 4 resultados pueden ocurrir:
- La versión del paquete nativo (1.2.3) es menor que la versión del paquete Capgo (1.2.4), Capgo envía el paquete al usuario.
- La versión del paquete nativo (1.2.3) es igual a la versión del paquete Capgo (1.2.3), Capgo envía 'no es necesario actualizar'.
- La versión del paquete nativo (1.2.4) es mayor que la versión del paquete Capgo (1.2.3), Capgo envía 'no es necesario actualizar'.
- La versión nativa del paquete (1.2.3) es MAYOR que Capgo versión del paquete (2.2.3), Capgo envía “no es necesario actualizar”.
Otras configuraciones
Deshabilitar la actualización automática bajo nativo
Si cambias esta configuración a falso, Capgo considerará siempre la fuente confiable de la versión.
- The native version (1.2.4) is higher than Capgo version (1.2.3)
La versión nativa (1.2.4) es mayor que Capgo versión (1.2.3)
__CAPGO_KEEP_0__ envía su versión al usuario.
Deshabilitar la estrategia de actualización automática Hay un par de estrategias que puedes elegir. Puedes aprender más sobre ellas
aquí
Versión del paquete de JavaScript npx @capgo/cli@latest bundle upload --channel production
La versión del paquete de JavaScript es la que envías cuando haces un ‘__CAPGO_KEEP_0__’ --bundle 1.2.3Capgo obtendrá la versión del paquete desde su package.json archivo (en la clave de versión).
Después de que su aplicación Ionic ha instalado una versión de Capgo, esta es la versión que se comparará para:
- Su versión de JavaScript del paquete (1.2.3) es menor que la versión del paquete Capgo (1.2.4), Capgo envía su paquete al usuario.
Con algunas condiciones de guardia:
- Si la versión nativa del paquete es mayor que la versión Capgo, se aplica la condición.
Disable auto downgrade under nativeSi la versión nativa del paquete es mayor en versión principal que la versión __CAPGO_KEEP_0__, se aplica la condición. - If native bundle version is MAJOR lower than Capgo version, the
Disable auto upgrade above majorCuando publique su aplicación __CAPGO_KEEP_0__ JS en la Tienda de Aplicaciones, lo que sucede es simple.
Su usuario obtendrá la nueva versión desde la tienda y eliminará todas las actualizaciones locales en su aplicación por defecto.
When you publish your Capacitor JS app on the App Store, what happens is simple.
__CAPGO_KEEP_0__
Si deseas cambiar ese comportamiento, debes configurar la configuración resetWhenUpdate Lee más sobre ello aquí
Esta configuración solo se puede cambiar en el lado de la aplicación, no desde la nube como otros ajustes.
Otros ajustes
Después de todo este comportamiento, puedes tener encima algunos específicos uno relacionado con el dispositivoID.
In Capgo, puedes decidir sobrescribir el comportamiento para cada dispositivoID.
Puedes vincular un dispositivoID a:
- una versión de paquete específica
- un canal específico
Esto ignorará todos los ajustes realizados anteriormente.
Aprende más sobre ello en el artículo de abajo.
Seguir adelante desde ¿Cómo funcionan las versiones en Capgo
Si estás utilizando ¿Cómo funcionan las versiones en Capgo para planificar el trabajo de plugins nativos, conecta con Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para los detalles de implementación en Capacitor Plugins por Capgo, Agregar o Actualizar Plugins para los detalles de implementación en Agregar o Actualizar Plugins, Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise, y Capgo Compilaciones nativas para el flujo de trabajo del producto en Capgo Compilaciones nativas.