Version Tagging in Capacitor Apps

La balise de version est essentielle pour gérer Capacitor applications. Cela garantit des mises à jour fluides, suit les changements et améliore la fiabilité des applications sur les plateformes iOS, Android et web. Voici un aperçu rapide :

• Pourquoi Cela CompteSuivi des mises à jour, permet l'annulation et garantit des déploiements stables.
• Versionnement Sémantique: Utilisez MAJ.MIN.PATCH to indicate breaking changes, new features, or bug fixes.
• Sync Across Platesformes: Aligner les numéros de version dans package.json, iOS Info.plist, et Android build.gradle.
• Automation: Automatiser les mises à jour avec des scripts npm et des outils CI/CD.
• Mises à jour en direct: Outils comme Capgo délivrer des mises à jour à 95 % des utilisateurs en 24 heures.
• Gestion de la Bêta: Utiliser des canaux structurés pour les versions alpha, bêta et de production.

Comparaison Rapide

La balise de version simplifie app updates, garde les utilisateurs heureux et permet aux développeurs de gérer les releases efficacement.

Comment configurer automatiquement votre Capacitor Projet ⚡️

Configuration de version dans Capacitor

Suivez ces étapes pour garantir une gestion cohérente des versions sur tous les plateformes dans votre application Capacitor.

Configuration de la version dans package.json

Le package.json fichier constitue la source principale des détails de version de votre application. Voici un exemple de mise en œuvre :

{
  "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"
  }
}

Lorsque vous mettez à jour le numéro de version, utilisez les règles de versionnement sémantique (SemVer) :

• Version majeure (1.x.x) : Introduit des changements de rupture.
• Version mineure (x.2.x) : Ajoute de nouvelles fonctionnalités qui sont compatibles en arrière-plan.
• Numéro de version de correctif (x.x.3): Corrige les bogues ou apporte des améliorations mineures.

Gestion des versions de plateforme

Il est important d'aligner les numéros de version sur tous les plateformes pour un déploiement d'applications fluide. Chaque plateforme possède son propre fichier de configuration pour la versionnage.

Après mise à jour de la version dans package.json, utilisez cette commande pour synchroniser les modifications avec les configurations de plateforme native :

npx cap sync

Utilisation de Capacitor CLI pour la gestion de version

Le Capacitor CLI propose des commandes utiles pour gérer les versions :

# 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

Maintenir votre Capacitor CLI à jour garantit la compatibilité avec les fonctionnalités spécifiques à la version et réduit les éventuelles incohérences. Suivre ces étapes vous aidera à maintenir une version correcte dans votre application.

Configuration de la version Sémantique

Principes de la version Sémantique

Versionnement Sémantique (SemVer) utilise la forme MAJOR.MINOR.PATCHoù chaque partie indique un type spécifique de modification :

Ce système permet aux développeurs de communiquer clairement les mises à jour tout en préservant la compatibilité entre les différentes versions d'applications. Par exemple, passer d'une version à une autre. 1.2.3 à 2.0.0 mises à jour majeures, importantes qui nécessitent une planification soigneuse.

Quand mettre à jour les numéros de version

Voici comment décider quel numéro de version mettre à jour :

“Nous pratiquons le développement agile et @Capgo est essentiel à la livraison continue à nos utilisateurs !” - Rodrigo Mantica [1]

Examinaons maintenant comment automatiser ces mises à jour pour simplifier la gestion des versions.

Mise à jour de version automatisée

Mise à jour automatique de version Pouvez-vous économiser du temps et réduire les erreurs dans votre projet Capacitor. Voici comment l'installer.

1. NPM Scripts de version

Ajoutez ces scripts à votre package.json file to manage version updates easily:

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

2. Intégration CI/CD
   Intégrez les mises à jour de version dans votre pipeline CI/CD. Capgo prend en charge des outils comme GitHub Actions, GitLab CI, et Jenkins, ce qui rend simple l'automatisation du processus.

“@Capgo est un outil indispensable pour les développeurs cherchant à gagner du temps en évitant les longues revues de correctifs.” - Bessie Cooper [1]

Méthodes de Tag de Version

Tags de Version Git

Les tags de version Git sont un moyen fiable de suivre les Sorties d'applications CapacitorPour créer des étiquettes claires et informatives, combinez la versionnement sémantique avec une brève description :

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

Pour maintenir la cohérence au sein de votre équipe, utilisez un format de balise normalisé :

Intégration du Numéro de Construction

Numéros de build aident à suivre les builds individuels au sein de chaque version. Pour les deux iOS et Android, incrémentez le numéro de build à chaque soumission :

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

Le numéro de build doit toujours augmenter, même si la version reste la même. Cela garantit que chaque soumission dans les magasins d'applications est identifiée de manière unique tout en maintenant la versionnage clair pour les utilisateurs.

Gestion de la version bêta

Gérer les versions bêta nécessite un processus structuré pour distribuer les builds de test. Capgo’s le système de canal simplifie cela avec les étapes suivantes :

1. Configuration du canal

Créez des canaux séparés pour chaque phase de test :

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

2. Contrôle de l'accès des utilisateurs

Configurez les permissions pour contrôler qui a accès aux versions bêta. Cela garantit que seuls les testeurs approuvés reçoivent les builds bêta tandis que les utilisateurs de production reçoivent des versions stables.

3. Progression de la version

Utilisez un système de progression de version clair pour suivre les étapes de développement :

Ce processus garantit une vérification approfondie et des transitions fluides entre les étapes de développement, en maintenant la gestion des versions organisée et transparente tout au long du processus.

Affichage de la version de l'application

Afficher des informations de version précises dans votre application est essentiel pour tenir les utilisateurs informés et gérer les mises à jour efficacement.

Obtenir la version avec Capacitor

Vous pouvez récupérer les détails de version à l'aide de Capacitor avec ce code.

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

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

Pour une approche plus fluide, créez une fonction réutilisable :

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

Cette fonction simplifie le processus d'affichage des informations de version dans l'interface de votre application.

Implémentation de l'interface de version

Ici est un exemple de comment intégrer l'affichage de la version dans un composant de paramètres :

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

Les endroits courants pour afficher les détails de version incluent :

In plus de l'affichage des informations de version, l'intégration d'un système de vérification des mises à jour peut améliorer l'expérience utilisateur.

Système de Contrôle de Mise à Jour

Un système de vérification des mises à jour garantit aux utilisateurs l'accès aux dernières fonctionnalités et correctifs. Capgo fournit des notifications en temps réel et des canaux de mise à jour contrôlés pour gérer ce processus:

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

“Nous pratiquons le développement agile et @Capgo est essentiel à la livraison continue à nos utilisateurs !” - Rodrigo Mantica [1]

You can also add a user-facing update notification, like this:

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

Pour les applications d'entreprise, le système de canaux de Capgo permet de contrôler la distribution des mises à jour:

Cette méthode garantit la fiabilité de l'application tout en suivant les performances de mise à jour à travers le tableau de bord d'analytique de Capgo.

Solutions de gestion de version

Plongons plus profondément dans les solutions avancées pour gérer efficacement les versions d'applications.

Options d'outil de version

When selecting version control tools, it’s important to focus on those that simplify updates, secure your code, and support both app store releases and live updates.

Voici quelques fonctionnalités clés à rechercher :

Un outil notable dans ce domaine est Capgo, qui propose des fonctionnalités conçues spécifiquement pour Applications Capacitor.

Capgo Caractéristiques de Contrôle de Version

Capgo offre des capacités de gestion de version robustes, notamment :

• 23,5M mises à jour réussies livrées
• 95% des utilisateurs mis à jour en 24 heures
• 82% de taux de réussite mondial
• 434ms temps de réponse moyen mondial API

Voici un exemple de mise en œuvre de Capgo pour le contrôle de version :

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

“Nous essayons actuellement @Capgo depuis que Appcenter a cessé le support des mises à jour en direct pour les applications hybrides et @AppFlow est trop coûteux.” - Simon Flack [1]

Taille d'équipe Solutions

Capgo propose des plans flexibles pour accueillir les équipes de toutes tailles, ce qui rend la gestion de version scalable et efficace.

Pour les équipes plus importantes, le système de canal de Capgo permet un contrôle précis de la mise en ligne des versions.

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

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

“Nous pratiquons le développement agile et @Capgo est essentiel pour livrer continuellement à nos utilisateurs !” - Rodrigo Mantica [1]

Capgo comprend également un tableau de bord d'analytique pour surveiller les taux d'adoption de version et détecter les problèmes potentiels dès le début. Avec une encryption intégrée et des options d'hébergement personnalisables, les équipes peuvent maintenir la sécurité tout en élargissant leurs flux de déploiement.

Conclusion

Comprendre la gestion des versions est essentiel pour simplifier les processus de développement et de déploiement. Voici un aperçu rapide des principes et étapes clés pour démarrer.

Principaux Résultats

La balise de version aide les développeurs à maintenir des mises à jour fluides et fiables. Un contrôle de version approprié offre des avantages clairs :

Ces résultats mettent en évidence l'importance d'utiliser des outils de gestion de version efficaces.

Comment Commencer

Pour mettre ces avantages en action, suivez ces étapes :

• Configurer la suivi de version: Utilisez la versionnement semantique dans votre package.json fichier et intégrez les plugins nécessaires.
• Vérifier les mises à jourImplémentez des systèmes pour vérifier et suivre les mises à jour de version.
• Configurer les canaux de distributionCréez des environnements séparés pour la production, la bêta et le développement.

Ajoutez finalement un système de live update pour garantir que les déploiements soient à la fois rapides et sécurisés.

Continuez de la version Tagging dans les Capacitor Applications

Si vous utilisez Version Tagging dans les Capacitor Applications pour planifier le rollback et le contrôle de version, connectez-l’avec Retour en arrière pour les détails d'implémentation dans les Rollbacks, Versionnement pour les détails d'implémentation dans la ciblage de version. Mise à jour du comportement pour le détail d'implémentation dans le comportement de mise à jour. bundle pour les détails d'implémentation dans le bundle, et Capgo Live Updates for the product workflow in Capgo Live Updates.