Etiquetado de Versión en Aplicaciones Capacitor

El etiquetado de versión es esencial para gestionar Capacitor apps. Garantiza actualizaciones suaves, registra cambios y mejora la confiabilidad de la aplicación en las plataformas iOS, Android y web. Aquí tienes un resumen rápido:

• Por qué Importa: Registra actualizaciones, habilita devoluciones a versiones anteriores y garantiza despliegues estables.
• Semántica de la Versión: Utiliza MAJOR.MINOR.PATCH para indicar cambios importantes, nuevas características o correcciones de errores.
• Sincronización en Plataformas: Alinea los números de versión en package.json, iOS Info.plist, y Android build.gradle.
• Automatización: Automatice actualizaciones con npm scripts y herramientas de CI/CD.
• Actualizaciones en vivo: Herramientas como Capgo entregan actualizaciones a un 95% de usuarios en 24 horas.
• Gestión de Beta: Utilice canales estructurados para versiones alpha, beta y de producción.

Comparación rápida

Etiquetado de versiones simplifica actualizaciones de la aplicaciónmantiene a los usuarios felices y garantiza que los desarrolladores puedan gestionar las versiones de manera efectiva.

¿Cómo configurar AUTOMÁTICAMENTE tu Capacitor proyecto ⚡️

Configuración de Versión en Capacitor

Sigue estos pasos para garantizar una gestión de versiones consistente en todas las plataformas de tu aplicación Capacitor.

Establecer la Versión en package.json

El package.json archivo es la fuente principal para los detalles de la versión de tu aplicación. Aquí tienes un ejemplo de cómo configurarlo:

{
  "name": "your-app-name",
  "version": "1.2.3",
  "private": true,
  "dependencies": {
    "@capacitor/core": "5.5.0",
    "@capacitor/ios": "5.5.0",
    "@capacitor/android": "5.5.0"
  }
}

Cuando se actualiza el número de versión, utilice las reglas de numeración semántica (SemVer):

• Versión mayor (1.x.x): Introduce cambios disruptivos.
• Versión menor (x.2.x): Agrega nuevas características que son compatibles hacia atrás.
• Versión de parche (x.x.3): Corrige errores o hace mejoras pequeñas.

Mantener las versiones de plataforma sincronizadas

Es importante alinear los números de versión en todas las plataformas para una implementación de aplicaciones suave. Cada plataforma tiene su propio archivo de configuración para la numeración de versiones:

Después de actualizar la versión en package.jsonUse this command to sync the changes with native platform configurations:

npx cap sync

Using Capacitor CLI for Version Management

La Capacitor CLI ofrece comandos útiles para gestionar versiones:

# Check the current version of Capacitor
npx cap --version

# Update Capacitor core and platform dependencies
npm install @capacitor/core@latest
npm install @capacitor/ios@latest
npm install @capacitor/android@latest

# Sync version changes to native platforms
npx cap sync

Mantener actualizada tu Capacitor CLI garantiza la compatibilidad con características específicas de la versión y reduce el riesgo de incompatibilidades.

Configuración de la versión semántica

Bases de la versión semántica

La versión semántica (SemVer) utiliza el formato Componente de versiónPropósito

Corrige errores o mejora el rendimiento sin romper la compatibilidad 1.2.3 Este sistema garantiza que los desarrolladores puedan comunicar actualizaciones de manera clara mientras se mantiene la compatibilidad entre versiones de la aplicación. Por ejemplo, pasar de 2.0.0 a

indica actualizaciones importantes que requieren un planificación cuidadosa.

¿Cuándo Actualizar Números de Versión

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” - Rodrigo Mantica [1]

“Practicamos el desarrollo ágil y @__CAPGO_KEEP_0__ es crucial para entregar continuamente a nuestros usuarios!” - Rodrigo Mantica

Ahora, veamos cómo automatizar estas actualizaciones para simplificar la gestión de versiones.

Automatización de Actualizaciones de Versión can save time and reduce errors in your Capacitor project. Here’s how to set it up:

1. puede ahorrar tiempo y reducir errores en su proyecto de NPM. Aquí está cómo configurarlo:

__CAPGO_KEEP_0__ Scripts de Versión package.json archivo para gestionar actualizaciones de versión de manera fácil:

{
  "scripts": {
    "version:patch": "npm version patch",
    "version:minor": "npm version minor",
    "version:major": "npm version major"
  }
}

2. Integración CI/CD
   Incorpora actualizaciones de versión en tu pipeline de CI/CD. Capgo admite herramientas como GitHub Actions, GitLab CI, y Jenkins, lo que facilita la automatización del proceso.

“@Capgo es una herramienta imprescindible para los desarrolladores que buscan productividad al evitar revisiones de bug largas.” - Bessie Cooper [1]

Métodos de Etiquetas de Versión de Git

Etiquetas de Versión de Git

Las etiquetas de versión de Git son una forma confiable de seguir el rastro de Capacitor lanzamientos de aplicaciones. Para crear etiquetas claras e informativas, combina la versión semántica con una breve descripción:

git tag -a v1.2.3 -m "Release v1.2.3: Added offline mode support"

Para mantener la consistencia en tu equipo, utiliza un formato de etiquetado estándar:

Integración de Número de Construcción

Los números de construcción ayudan a rastrear las construcciones individuales dentro de cada versión. Para tanto iOS y Android, incremente el número de construcción con cada envío:

{
  "ios": {
    "version": "1.2.3",
    "build": "10234"
  },
  "android": {
    "version": "1.2.3",
    "versionCode": "10234"
  }
}

El número de construcción debe aumentar siempre, incluso si la versión permanece igual. Esto garantiza que cada envío a la tienda de aplicaciones se identifique de manera única mientras se mantiene la versión clara para los usuarios.

Gestión de Versión de Beta

La gestión de versiones beta requiere un proceso estructurado para distribuir construcciones de prueba. Capgo’s sistema de canal simplifica esto con los siguientes pasos:

1. Configuración de Canal

Cree canales separados para cada fase de prueba:

{
  "beta": {
    "version": "1.3.0-beta.1",
    "users": "beta-testers"
  },
  "production": {
    "version": "1.2.3",
    "users": "all"
  }
}

2. Control de Acceso del Usuario

Configura permisos para controlar quién tiene acceso a versiones beta. Esto garantiza que solo los probadores aprobados reciban versiones beta mientras que los usuarios de producción obtengan lanzamientos estables.

3. Progresión de Versión

Utiliza un sistema de progresión de versión claro para rastrear las etapas de desarrollo:

Esta aproximación garantiza pruebas exhaustivas y transiciones suaves entre las etapas de desarrollo, manteniendo el seguimiento de versiones organizado y transparente a lo largo del proceso.

Mostrar versión de la aplicación

Mostrar información de versión precisa en tu aplicación es clave para mantener a los usuarios informados y gestionar actualizaciones de manera efectiva.

Obtener versión con Capacitor

Puedes recuperar detalles de versión utilizando Capacitor con este code:

import { App } from '@capacitor/app';

async function getAppInfo() {
  const info = await App.getInfo();
  console.log(`Version: ${info.version}`);
  console.log(`Build: ${info.build}`);
}

Para un enfoque más escalable, crea una función reutilizable:

export const getVersionString = async () => {
  const info = await App.getInfo();
  return `v${info.version} (${info.build})`;
};

Esta función simplifica el proceso de mostrar información de versión en la interfaz de tu aplicación.

Implementación de interfaz de versión

Aquí tienes un ejemplo de cómo integrar la visualización de la versión en un componente de ajustes:

@Component({
  selector: 'app-settings',
  template: `
    <div class="version-info">
      <span>Version: {{ versionString }}</span>
      <span *ngIf="updateAvailable" class="update-badge">
        Update Available
      </span>
    </div>
  `
})

Los lugares comunes para mostrar detalles de versión incluyen:

Además de mostrar información de versión, integrar un sistema de verificación de actualizaciones puede mejorar la experiencia del usuario.

Sistema de verificación de actualizaciones

Un sistema de verificación de actualizaciones garantiza que los usuarios tengan acceso a las últimas características y correcciones. Capgo proporciona notificaciones en tiempo real y canales de actualización controlados para gestionar este proceso:

import { CapacitorUpdater } from '@capgo/capacitor-updater';

async function checkForUpdates() {
  const current = await CapacitorUpdater.current();
  const latest = await CapacitorUpdater.getLatest();

  if (current.version !== latest.version) {
    await CapacitorUpdater.download({
      version: latest.version
    });
  }
}

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” - Rodrigo Mantica [1]

“Practicamos el desarrollo ágil y @__CAPGO_KEEP_0__ es crucial para entregar de manera continua a nuestros usuarios!” - Rodrigo Mantica

@Component({
  template: `
    <update-modal 
      [version]="newVersion"
      [features]="updateFeatures"
      (updateNow)="performUpdate()"
    />
  `
})

For enterprise apps, Capgo’s channel system allows you to control update distribution:

Esta método garantiza la confiabilidad de la aplicación mientras rastrea el rendimiento de las actualizaciones a través del panel de seguimiento de Capgo.

Soluciones de gestión de versiones

¡Vamos a profundizar en soluciones avanzadas para gestionar versiones de aplicaciones de manera efectiva.

Opciones de Herramienta de Versión

Al seleccionar herramientas de control de versiones, es importante centrarse en aquellas que simplifiquen las actualizaciones, protejan su code, y apoyen tanto las liberaciones de tiendas de aplicaciones como las actualizaciones en vivo.

Aquí hay algunas características clave a buscar:

Una herramienta destacada en este espacio es Capgo, que ofrece características diseñadas específicamente para Capacitor aplicaciones.

Capgo Características de Control de Versión

Capgo ofrece capacidades de gestión de versiones robustas, incluyendo:

• 23,5M actualizaciones exitosas entregadas
• El 95% de los usuarios se actualizó dentro de 24 horas
• Un 82% de tasa de éxito global
• 434ms tiempo de respuesta promedio de API en todo el mundo

Aquí hay un ejemplo de cómo utilizar Capgo para el control de versiones:

// Capgo version control example
import { CapacitorUpdater } from '@capgo/capacitor-updater';

const versionControl = {
  async checkVersion() {
    const current = await CapacitorUpdater.current();
    return current.version;
  },

  async deployUpdate(version: string) {
    await CapacitorUpdater.setChannel({
      channel: 'production',
      version: version
    });
  }
};

“We are currently giving a try to @Capgo since Appcenter stopped live updates support on hybrid apps and @AppFlow is way too expensive.” - Simon Flack [1]

“Estamos probando actualmente a @__CAPGO_KEEP_0__ desde que Appcenter dejó de apoyar actualizaciones en vivo en aplicaciones híbridas y @AppFlow es demasiado caro.” - Simon Flack

Capgo offers flexible plans to accommodate teams of all sizes, making version management scalable and efficient.

Para equipos más grandes, el sistema de canales de Capgo permite un control preciso sobre la versión de despliegue:

const enterpriseVersionControl = {
  channels: {
    production: 'stable-releases',
    beta: 'early-access',
    internal: 'development'
  },

  async deployToChannel(channel: string, version: string) {
    await CapacitorUpdater.setChannel({
      channel: channel,
      version: version
    });
  }
};

“Practicamos el desarrollo ágil y @Capgo es crucial para entregar continuamente a nuestros usuarios!” - Rodrigo Mantica [1]

Capgo también incluye una consola de análisis para monitorear las tasas de adopción de versiones y detectar problemas potenciales temprano. Con cifrado integrado y opciones de alojamiento personalizables, los equipos pueden mantener la seguridad mientras escalan sus flujos de trabajo de despliegue.

Conclusión

Entender la etiquetado de versiones es clave para simplificar los procesos de desarrollo y despliegue. Aquí hay un resumen rápido de las ideas principales y pasos para empezar.

Resultados clave

La etiquetado de versiones ayuda a los desarrolladores a mantener actualizaciones suaves y fiables. Un control de versiones adecuado ofrece ventajas claras:

Estos resultados destacan la importancia de utilizar herramientas de gestión de versiones efectivas.

Cómo Empezar

Para poner en práctica estos beneficios, sigue estos pasos:

• Configurar el seguimiento de versiones: Utiliza la versión semántica en tu archivo y integra los plugins necesarios. package.json Agregar comprobaciones de actualizaciones
• : Implementa sistemas para verificar y rastrear actualizaciones de versiones.Configurar canales de distribución
• : Crea entornos separados para producción, beta y desarrollo.Finalmente, considera agregar un sistema de actualizaciones en vivo para asegurar que las implementaciones sean tanto rápidas como seguras.

__CAPGO_KEEP_0__