¿Quieres simplificar actualizaciones de aplicaciones y control de versiones? La versión semántica (SemVer) combinada con Capgoactualizaciones OTA de Capacitor hacen que gestionar aplicaciones sea más fácil y rápido. Aquí está cómo hacerlo:
-
Bases de la versión semántica: Versión usa el formato
MAJOR.MINOR.PATCH:- MAJOR: Para cambios importantes.
- MINOR: Para nuevas características que son compatibles hacia atrás.
- PATCH: ¿Por qué usar SemVer con __CAPGO_KEEP_0__?
-
Why Use SemVer with Capgo?
- Gestión de versiones más inteligente.
- Evitar conflictos de dependencias.
- Planificación de lanzamientos organizada.
- __CAPGO_KEEP_0__
-
Capgo Configuración Pasos:
- Instale el plugin de actualizador de Capgo.
- Configure la versión de su aplicación en
capacitor.config.jsony otros archivos. - Inicie con su clave de API.
- Utilice Capgo CLI para empaquetar y subir actualizaciones.
-
- Utilice canales separados (por ejemplo, "beta" para pruebas, "producción" para lanzamientos estable).
- Controlar políticas de actualización (actualizaciones automáticas de parches, aprobación manual para cambios importantes).
- Opciones de rollback para actualizaciones fallidas.
-
Proceso de despliegue:
- Actualice los números de versión siguiendo las reglas de SemVer.
- Pruebe exhaustivamente antes de desplegar.
- Utilice comandos CLI para subir y distribuir actualizaciones.
Capgo garantiza que las actualizaciones lleguen a los usuarios de manera rápida y confiable, con herramientas para manejar interrupciones y mantener la estabilidad. Ideal para equipos que utilizan flujos de trabajo CI/CD para automatizar actualizaciones.
Consejo rápido: Siempre pruebe actualizaciones y utilice canales para gestionar despliegues de etapas de manera efectiva.
Versión Semántica | Nivel Up
Capgo Guía de configuración
Aquí está cómo configurar Capgo para gestionar actualizaciones OTA y control de versiones con facilidad.
Pasos de Configuración Inicial
Comience instalando el Capgo plugin de actualizador:
npm install @capgo/capacitor-updater
npx cap syncAsegúrese de que su capacitor.config.json archivo utilice un formato de versión semántica:
{
"appId": "com.example.app",
"appName": "My App",
"version": "1.0.0"
}Para proyectos más antiguos, actualice los detalles de versión en estos lugares:
package.json(busque el campoversion(actualiceandroid/app/build.gradle(actualiceversionName)ios/App/App.xcodeproj/project.pbxproj__CAPGO_KEEP_0__CURRENT_PROJECT_VERSION)
Una vez configurado, inicialice Capgo con su clave API:
npx @capgo/cli@latest init YOUR_API_KEYTabla de Referencia Rápida:
| Fase de Configuración | Acción de la Clave | Paso de Verificación |
|---|---|---|
| Instalación | Instale el plugin y sincronice | Verifique package.json |
| Configuración | Establezca los números de versión | Verifique en todos los archivos |
| Iniciación | Conecta con la clave API | Estado de conexión de prueba |
| Construir | Crear el paquete inicial | Confirmar éxito de subida |
Integración de control de versiones
Capgo funciona bien con plataformas de CI/CD, lo que hace actualizaciones automatizadas fáciles. Las plataformas admitidas incluyen:
Si estás trabajando en desarrollo local, puedes deshabilitar las actualizaciones automáticas agregando esto a tu configuración:
{
"plugins": {
"CapacitorUpdater": {
"autoUpdate": false
}
}
}Esto garantiza que Capgo no sobreescriba tus cambios locales. Una vez que tengas tu configuración lista, sube tu primera versión:
npx @capgo/cli@latest bundle upload
npx @capgo/cli@latest channel set production -s defaultFinalmente, notifica al plugin nativo sobre el estado del paquete en el archivo principal de tu aplicación:
import { CapacitorUpdater } from '@capgo/capacitor-updater';
CapacitorUpdater.notifyAppReady();Esta configuración garantiza que tu aplicación esté lista para despliegues OTA suaves y gestión de versiones.
Uso de la Semántica de la Versión con Capgo
Gestión del Número de Versión
Capgo utiliza la Semántica de la Versión (SemVer) para gestionar las versiones de la aplicación, formateadas como X.0.0Versión Mayor (X.0.0)
- La Versión Mayor (X.0.0)Aumente el número MAJOR para cambios que rompen la compatibilidad.
- Versión menor (1.X.0)Aumente el número MINOR para nuevas características que siguen siendo compatibles.
- Versión de parche (1.0.X)Tipo de versión
| Cuándo incrementar | Comportamiento de actualización automática | Mayor (X.0.0) |
|---|---|---|
| Para cambios de __CAPGO_KEEP_0__ que rompen la compatibilidad | For breaking API changes | Menor (1.X.0) |
| Para cambios que no afectan la compatibilidad | Para nuevas características | Configurable en Capgo |
| Patch (1.0.X) | Para correcciones de errores | Normalmente automático |
Al seguir las reglas de SemVer, puedes simplificar la gestión de versiones y asegurar actualizaciones más suaves a través de tus canales de despliegue.
Directrices de Control de Versiones
Capgo te permite gestionar los despliegues de manera efectiva al configurar canales distintos para diferentes etapas de tu flujo de trabajo.
-
Gestión de Versiones por Canales: Organiza tu proceso de despliegue creando canales separados para pruebas y producción. Por ejemplo:
- Utiliza un canal de “beta” (por ejemplo, 1.2.0-beta) para probar nuevas características.
- Mantén un canal de “producción” (por ejemplo, 1.2.0) para lanzamientos estable.
- Agregar canales específicos de plataforma (por ejemplo, “ios-hotfix” con la versión 1.2.1) al abordar problemas específicos de plataforma.
-
Actualizar Configuración de Política: Controlar cómo se aplican las actualizaciones utilizando opciones de configuración de Capgo.
{ "plugins": { "CapacitorUpdater": { "disableAutoUpdate": "minor" } } }Por ejemplo:
-
Esta configuración garantiza que los usuarios reciben automáticamente actualizaciones de parche, mientras que las actualizaciones menores y mayores requieren aprobación manual.Estrategia de Reversión de Versión
: Utilizar identificadores de pre-lanzamiento para mantener opciones de reversión claras. Esta aproximación permite revertir a una versión anterior si ocurren problemas, mientras se mantiene la consistencia en la versión en todos los canales.
Estas mejores prácticas facilitan la gestión de actualizaciones, probar nuevas características y mantener la estabilidad en el proceso de despliegue de la aplicación.
sbb-itb-f9944d2
Despliegue de Actualizaciones OTA
Una vez que su configuración de gestión de versiones esté lista, siga estos pasos para desplegar actualizaciones OTA de manera efectiva.
Preparación de Actualizaciones package.json y capacitor.config.jsonAsegúrese de que la versión siga el formato SemVer (NÚMERO.MAÑOR.REVISIÓN):
- Corrección de errores: Incrementar el número de REVISIÓN (por ejemplo, 1.0.1 → 1.0.2)
- Nueva característica: Incrementar el número de MAÑOR (por ejemplo, 1.0.0 → 1.1.0)
- Cambio disruptivo: Incrementar el número de NÚMERO (por ejemplo, 1.0.0 → 2.0.0)
Pruebe exhaustivamente su compilación y confirme que la aplicación se comunica con el servidor usando notifyAppReady.
A continuación, decida sobre su Estrategia de actualización. Puede elegir entre:
- Actualización Automática: Aplica automáticamente los requisitos de versión mínimos.
- Control Manual: Establece requisitos de versión exactos para las actualizaciones.
- Basada en Canal: Utilice canales para pruebas y lanzamientos escalonados.
Capgo CLI Comandos de Actualización
Use Capgo’s CLI para desplegar su actualización con facilidad. Aquí está cómo:
# Initialize Capgo in your project
npx @capgo/cli@latest init [apikey]
# Upload your update bundle
npx @capgo/cli bundle upload [appId]
# Add a new distribution channel
npx @capgo/cli channel add [channelId] [appId]Capgo garantiza un despliegue seguro con cifrado de extremo a extremo y gestión de claves seguras.
“@Capgo is a smart way to make hot code pushes (and not for all the money in the world like with @AppFlow) 🙂”
Una vez desplegado, puede monitorear actualizaciones a través de la consola de Capgo.
- Las actualizaciones suelen llegar a los usuarios en minutos después de que abran la aplicación.
- El proceso funciona de la siguiente manera:
- La aplicación verifica actualizaciones.
- Descarga la actualización en segundo plano.
Marca la nueva versión como activa cuando el usuario sale de la aplicación.
“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!”
Para despliegues de nivel empresarial, es posible que desee integrar la automatización de CI/CD.
“Practicamos el desarrollo ágil y @__CAPGO_KEEP_0__ es crucial en la entrega continua a nuestros usuarios!”
Managing semantic versioning in Capgo can sometimes complicate update deployments. To avoid overwriting your development work, configure the following in your capacitor.config.json Problemas de Gestión de Versiones
{
"plugins": {
"CapacitorUpdater": {
"autoUpdate": false
}
}
}La gestión de versiones semánticas en __CAPGO_KEEP_0__ puede complicar a veces los despliegues de actualizaciones. Para evitar sobreescribir su trabajo de desarrollo, configure lo siguiente en su archivo: «file:».
- Establecer
autoUpdatedurante el desarrollo.falseDesinstalar la aplicación. - Reinstalarla con la versión corregida.
- Rehabilitar las actualizaciones automáticas una vez que todo esté establecido.
- Para actualizaciones de versión mayor, utilice la bandera y escuche el evento para manejar las actualizaciones de manera adecuada:
Al combinar estas configuraciones con buenas prácticas de equipo, puede mantener la consistencia de versiones y reducir errores. disableAutoUpdateBreaking Control de Versiones de Equipo majorAvailable Una vez que se gestionan las actualizaciones individuales, es crucial que los equipos establezcan prácticas de control de versiones sólidas.
CapacitorUpdater.addListener('majorAvailable', (info) => {
console.log(`Major update available: ${info.version}`);
// Add your update prompt logic here
});Para actualizaciones de versión mayor, utilice la bandera __CAPGO_KEEP_0__ y escuche el evento __CAPGO_KEEP_1__ para manejar las actualizaciones de manera adecuada:
Al combinar estas configuraciones con buenas prácticas de equipo, puede mantener la consistencia de versiones y reducir errores. Una vez que se gestionan las actualizaciones individuales, es crucial que los equipos establezcan prácticas de control de versiones sólidas.
Control de Versiones de Equipo: Una vez que se gestionan las actualizaciones individuales, es crucial que los equipos establezcan prácticas de control de versiones sólidas.
“La prueba de cada cambio antes de fusionarlo con el repositorio principal reforzará la estabilidad y evitará errores costosos” [4]
Aquí hay algunas formas de garantizar la consistencia:
- Define una rama como el repositorio principal para actuar como fuente de verdad.
- Utiliza canales separados Capgo para entornos de desarrollo y producción.
- Automatiza las subidas de versiones a través de pipelines CI/CD.
- Documenta todos los code cambios con mensajes de commit claros y detallados.
Para equipos más grandes, la siguiente matriz de gestión de versiones puede ayudar a organizar las actualizaciones:
| Entorno | Canales | Actualización automática | Patrón de Versión |
|---|---|---|---|
| Desarrollo | dev | Deshabilitado | 0.x.x |
| Pruebas | beta | Habilitado | x.x.x-beta |
| Producción | estable | Habilitado | __CAPGO_KEEP_0__ |
Actualizar Pasos de Recuperación
Si bien se toman precauciones, las actualizaciones pueden fallar. Si eso sucede, sigue estos pasos de recuperación:
- Volver a una versión estable anterior.
- Aumentar los números de versión para cualquier nueva corrección (nota: los números de versión no pueden ser reutilizados después de la eliminación) [2].
- Verificar actualizaciones durante el arranque de la aplicación para asegurarse de que funcionen como se espera.
Capgo’s actualizador está diseñado para manejar interrupciones. Por ejemplo, si el servidor no está disponible o una actualización ha sido eliminada, la aplicación sigue funcionando normalmente [3]Además, las solicitudes de red fallidas se reintentan automáticamente durante el próximo arranque de la aplicación [3]Esta resistencia integrada minimiza el tiempo de inactividad y garantiza operaciones más suaves.
Resumen
La combinación de la versión semántica con Capgo ha hecho que las actualizaciones OTA para las aplicaciones Capacitor sean más eficientes. Con 947.6 millones de actualizaciones entregadas y 1,400 aplicaciones de producción que utilizan este sistema [1], los procesos de implementación han vuelto 81% más eficientes [1]. Esta configuración permite a los desarrolladores enviar actualizaciones de manera rápida y controlada, evitando los retrasos de las tiendas de aplicaciones.
Aquí lo que dicen los desarrolladores:
“Desplegamos actualizaciones OTA Capgo actualizaciones OTA en producción para nuestra base de usuarios de +5000. Estamos viendo una operación muy suave, casi todos nuestros usuarios están actualizados en minutos después de que se despliega la OTA en @Capgo.” - colenso [1]
El sistema de versionado MAJOR.MINOR.PATCH facilita la comunicación de cambios importantes, nuevas características y correcciones de errores [5]. Esto es especialmente útil para equipos que gestionan varias versiones cada semana a través de la plataforma de Capgo.
Capgo’s solución cifrada, integrada con herramientas CI/CD, también es asequible - reduce costos hasta $26,100 en cinco años [1]. Sus canales personalizables garantizan que las actualizaciones lleguen a los usuarios adecuados en el momento adecuado.
“Practicamos el desarrollo ágil y @Capgo es crucial en la entrega continua a nuestros usuarios!” - Rodrigo Mantica [1]
Sigue adelante desde Cómo usar la versión semántica con Capgo actualizaciones OTA
Si estás utilizando Cómo usar la versión semántica con Capgo actualizaciones OTA para planificar el rollback y el control de versiones, conecta con Rollbacks para los detalles de implementación en Rollbacks, Version Targeting para los detalles de implementación en Version Targeting, Comportamiento de Actualización para los detalles de implementación en Comportamiento de Actualización, paquete para los detalles de implementación en paquete, y Capgo Live Updates for the product workflow in Capgo Live Updates.
