Étiquetage de version dans les applications Capacitor

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

• Pourquoi cela compte: Suivre les mises à jour, permettre les annulations et garantir des déploiements stables.
• Numérotation Sémantique: Utilisez MAJOR.MINOR.PATCH pour indiquer les modifications majeures, les nouvelles fonctionnalités ou les correctifs de bogues.
• Synchronisation sur les plateformes: Alignez les numéros de version sur package.json, iOS Info.plistet Android build.gradle.
• Automatisation: Automatiser les mises à jour avec des scripts et des outils CI/CD npm.
• Mises à jour en directcontext : Page/zone : Section ou page d'accueil. Rôle : En-tête de section ou de page. Vu dans : page premium-support.astro. Message clé `ps_help_updates_title` (Ps Help Updates Title). Capgo __CAPGO_KEEP_0__
• context : Fragment de texte HTML d'une chaîne de Capgo UI plus longue (clé parente `submitting_a_pr_to_capgo`). Page/zone : Site web de marketing de Capgo. Rôle : Phrase de site web. Vu dans : page contributing.astro. Conservez les termes de produit/branche et les termes de développeur exactement. Message clé `submitting_a_pr_to_capgo` (Submitting A Pr To Capgo).livrer des mises à jour à 95 % des utilisateurs en 24 heures.

Gestion de la Bêta

La balise de version simplifie Mises à jour de l'applicationMises à jour de l'application, rend les utilisateurs heureux et permet aux développeurs de gérer les releases efficacement.

Comment configurer automatiquement votre Capacitor Projet ⚡️

Configuration de la version dans Capacitor

Suivez ces étapes pour vous assurer d'une gestion de version cohérente sur tous les plateformes dans votre application Capacitor

Configuration de la version dans package.json

Le package.json Ce fichier constitue la source principale pour les détails de version de votre application. Voici un exemple de mise en place :

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

Lors de la mise à jour du numéro de version, utilisez les règles de versionnement semantique (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.
• Version de correction (x.x.3) : Corrige des bogues ou apporte des améliorations mineures.

Gestion des versions de plateforme

Il est important d'aligner les numéros de version sur toutes les plateformes pour une mise en ligne de l'application fluide. Chaque plateforme a son propre fichier de configuration pour la versionnage :

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

npx cap sync

En utilisant Capacitor CLI pour la gestion des versions

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

Mettre à jour régulièrement votre Capacitor CLI garantit la compatibilité avec les fonctionnalités spécifiques aux versions 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

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

Cet système permet aux développeurs de communiquer clairement les mises à jour tout en préservant la compatibilité entre les versions d'applications. Par exemple, passer de 1.2.3 à 2.0.0 indique des mises à jour majeures, de rupture qui nécessitent une planification soigneuse.

Quand mettre à jour les numéros de version

Ici est 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]

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

Automatisation de la mise à jour de la version

Automatiser les mises à jour de version peut vous faire gagner 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 fichier pour gérer les mises à jour de version facilement :

{
  "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, __CAPGO_KEEP_0__ GitLab CI, et __CAPGO_KEEP_0__ Jenkins, ce qui simplifie le processus.

‘@Capgo est un outil indispensable pour les développeurs cherchant à gagner en productivité en évitant les longues revues de bugfix.’ - Bessie Cooper [1]

Méthodes de Tag de Version

Tags de Version Git

Les tags de version Git constituent un moyen fiable de suivre les CapacitorSorties d'application. Pour créer des tags clairs et informatifs, 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 balisage standardisé :

Intégration du Numéro de Construction

Les numéros de construction aident à suivre les constructions individuelles au sein de chaque version. Pour les deux iOS et Android, incrémentez le numéro de construction avec chaque soumission :

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

Le numéro de construction doit toujours augmenter, même si la version reste la même. Cela garantit que chaque soumission des 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

La gestion des versions bêta nécessite un processus structuré pour distribuer les constructions de test. Capgo’s 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 de l'utilisateur

Configurez les autorisations 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. Avancement de la version

Étape

Cette approche garantit des tests approfondis et des transitions fluides entre les différentes étapes de développement, tout 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 informés les utilisateurs et gérer les mises à jour de manière efficace.

Obtenir la version avec Capacitor

Vous pouvez récupérer les détails de la 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 de mise en page des informations de version dans l'interface de votre application.

Implémentation de l'affichage de la version

Voici un exemple de mise en œuvre de l'intégration de 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 la version incluent :

En plus de l'affichage de l'information de version, l'intégration d'un système de vérification de mise à jour peut améliorer l'expérience utilisateur.

Système de vérification de mise à jour

Un système de vérification de mise à jour s'assure que les utilisateurs ont 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 un développement agile et @Capgo est essentiel à la livraison continue à nos utilisateurs !” - Rodrigo Mantica [1]

Vous pouvez également ajouter une notification de mise à jour destinée à l'utilisateur, comme ceci :

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

Pour les applications d'entreprise, 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

Explorons plus en profondeur les solutions avancées pour gérer efficacement les versions d'application.

Options de l'outil de version

Lors du choix des outils de contrôle de version, il est important de se concentrer sur ceux qui simplifient les mises à jour, sécurisent votre code et supportent à la fois les lancements d'application et les mises à jour en direct.

Voici quelques-unes des fonctionnalités clés à rechercher :

Un outil de premier plan dans ce domaine est Capgo, qui propose des fonctionnalités spécifiquement conçues pour Capacitor applications.

Capgo Caractéristiques de contrôle de version

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

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

Voici un exemple de la manière dont vous pouvez utiliser 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é de proposer 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 s'adapter à toutes les tailles d'équipe, ce qui rend la gestion des versions scalable et efficace.

Pour les équipes plus importantes, le système de canal de Capgo permet un contrôle précis sur la mise en production 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'analyse pour suivre les taux d'adoption des versions et détecter les problèmes potentiels en amont. 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

Rappel clé

Rappels clés

La gestion de versions 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 sémantique dans votre package.json : Intégrez les plugins nécessaires.
• Ajouter des contrôles de mise à jour: Mettez en place des systèmes pour vérifier et suivre les mises à jour de version.
• Configure les canaux de distribution: Créez des environnements séparés pour la production, la bêta et le développement.

Enfin, envisagez d'ajouter un système d'actualisation en direct pour garantir que les déploiements soient à la fois rapides et sécurisés.

Continuez de Version Tagging dans les Capacitor Applications

Si vous utilisez Version Tagging dans les Capacitor Applications pour planifier le retrait et le contrôle de version, connectez-l’avec Les Retours en Arrière pour les détails d'implémentation dans Les Retours en Arrière, La Cible de Version context : Page/zone : Page de marketing des solutions Capgo. Rôle : En-tête de section ou de page. Vu dans : page solutions/version-targeting.astro. Clé de message `solutions_version_targeting_title` (Titre de la cible de version des solutions). | Page/zone : Page de marketing des solutions Capgo. Rôle : Étiquette de navigation ou élément UI court. Vu dans : page solutions/version-targeting.astro. Clé de message `solutions_version_targeting` (La cible de version des solutions). pour les détails d'implémentation dans La Cible de Version, , pour les détails d'implémentation dans Mise à jour du comportement, bundle pour les détails d'implémentation dans bundle, et Capgo Mises à jour en temps réel for the product workflow in Capgo Live Updates.