Etiquetado de versión en aplicaciones Capacitor

El etiquetado de versión es fundamental para la gestión de Capacitor aplicaciones. Garantiza actualizaciones suaves, rastrea cambios y mejora la confiabilidad de la aplicación en las plataformas iOS, Android y web. Aquí hay un resumen rápido:

• ¿Por qué Importa?: Rastrea actualizaciones, habilita devoluciones a versiones anteriores y garantiza despliegues estables.
• Versión Semántica: Utilice 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.
• Ayuda a la automatización: Automatiza actualizaciones con scripts y herramientas de CI/CD npm.
• Actualizaciones en vivo: Herramientas como Capgo entregan actualizaciones a 95% de los usuarios en 24 horas.
• Gestión de beta: Utiliza canales estructurados para versiones de alpha, beta y producción.

Comparación Rápida

La etiquetado de versiones simplifica actualizaciones de aplicaciones, mantiene a los usuarios felices y garantiza que los desarrolladores puedan gestionar las versiones de manera efectiva.

Cómo configurar AUTOMÁTICAMENTE su Capacitor proyecto ⚡️

Configuración de versión en Capacitor

Sigue estos pasos para asegurarte de que la gestión de versiones sea consistente en todas las plataformas de tu Capacitor app.

Configuración de la Versión en package.json

El package.json archivo es la fuente principal para los detalles de la versión de tu app. 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"
  }
}

Al actualizar el número de versión, utiliza las reglas de SemVer (versión semántica):

• Versión mayor (1.x.x): Introduce cambios que rompen la compatibilidad.
• 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 realiza mejoras pequeñas.

Mantener las versiones de las plataformas sincronizadas

Es importante alinear los números de versión en todas las plataformas para una despliegue de aplicación suave.

Después de actualizar la versión en package.json, utilice este comando para sincronizar los cambios con las configuraciones de plataforma nativa:

npx cap sync

Usando Capacitor CLI para Gestión de Versiones

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 actualizado su Capacitor CLI garantiza la compatibilidad con características específicas de la versión y reduce el riesgo de desacuerdos. Sigue estos pasos para mantener una versión adecuada en tu aplicación.

Configuración de Versión Semántica

Conceptos básicos de Versión Semántica

Versión Semántica (SemVer) usa el formato MAJOR.MINOR.PATCH, donde cada parte indica un tipo específico de cambio:

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 1.2.3 a 2.0.0 indica actualizaciones importantes y rompedoras que requieren un planificación cuidadosa.

Cuándo actualizar números de versión

Aquí está cómo decidir qué número de versión actualizar:

"Practicamos el desarrollo ágil y @Capgo es crucial en la entrega continua a nuestros usuarios!" - Rodrigo Mantica [1]

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

Automatización de Actualizaciones de Versión

Automatizar actualizaciones de versión puede ahorrar tiempo y reducir errores en su proyecto Capacitor. Aquí está cómo configurarlo:

1. NPM Scripts de Versión

Agregue estos scripts a su 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
   Incorpore actualizaciones de versión en su pipeline de CI/CD. Capgo admite herramientas como GitHub Acciones, CI de GitLab, y Jenkins CIautomatizar el proceso de manera sencilla.

“@Capgo es una herramienta imprescindible para los desarrolladores que buscan aumentar su productividad evitando revisiones de corrección de errores largas.” - Bessie Cooper [1]

Métodos de Etiquetas de Versión

Etiquetas de Versión de Git

Las etiquetas de versión de Git son una forma confiable de mantener un registro 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 dentro de su equipo, utilice un formato de etiquetado estandarizado:

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 sigue siendo la misma. Esto garantiza que cada envío a la tienda de aplicaciones sea identificado de manera única mientras se mantiene la versión clara para los usuarios.

Gestión de Versión Beta

Administrar versiones beta requiere un proceso estructurado para distribuir compilaciones de prueba. Capgo’s El sistema de canal facilita esto con los siguientes pasos:

1. Configuración de canal

Crear 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

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

3. Progresión de versión

Utilice un sistema de progresión de versión claro para seguir las etapas de desarrollo:

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

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 la 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>
  `
})

Lugares comunes para mostrar detalles de versión incluyen:

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

Sistema de Comprobación de Actualizaciones

An update check system ensures users have access to the latest features and fixes. Capgo provides real-time notifications and controlled update channels to manage this process:

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
    });
  }
}

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

Puede agregar también una notificación de actualización para el usuario, como este ejemplo:

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

Para aplicaciones empresariales, el sistema de canales de Capgo le permite controlar la distribución de actualizaciones:

Esta metodología garantiza la confiabilidad de la aplicación mientras se 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 las versiones de la aplicación de manera efectiva.

Opciones de Herramientas 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.

A continuación, se presentan 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 average API response time worldwide

Aquí hay un ejemplo de cómo utilizar Capgo para 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
    });
  }
};

“Estamos probando actualmente a @Capgo ya que Appcenter dejó de ofrecer actualizaciones en vivo para aplicaciones híbridas y @AppFlow es demasiado caro.” - Simon Flack [1]

Soluciones de tamaño de equipo

Capgo ofrece planes flexibles para acomodar equipos de todos los tamaños, lo que hace que el control de versiones sea escalable y eficiente.

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 posibles problemas 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.

Principales puntos clave

La etiquetado de versiones ayuda a los desarrolladores a mantener actualizaciones suaves y fiables.

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

Cómo Empezar

Para poner en acción estos beneficios, sigue estos pasos:

• Configura el seguimiento de versiones: Utiliza la numeración semántica en tu package.json archivo y integra los plugins necesarios.
• Agregar verificaciones de actualizaciones: Implementar sistemas para verificar y rastrear actualizaciones de versión.
• Configurar canales de distribución: Crear entornos separados para producción, beta y desarrollo.

Finalmente, considere agregar un sistema de actualizaciones en vivo para garantizar que las implementaciones sean tanto rápidas como seguras.

Sigue adelante desde Etiquetas de Versión en Capacitor Apps

Si estás utilizando Etiquetas de Versión en Capacitor Apps para planificar el rollback y el control de versiones, conecta con Rollbacks para los detalles de implementación en Rollbacks, Etiquetado de Versión para los detalles de implementación en Version Targeting, Actualizar Comportamiento para los detalles de implementación en Actualizar Comportamiento, paquete para los detalles de implementación en paquete, y Capgo Actualizaciones en Vivo para el flujo de trabajo del producto en Capgo Actualizaciones en Vivo.