Passer au contenu principal

Étiquetage de version dans les applications Capacitor

Découvrez les bases de l'étiquetage de version dans les applications Capacitor , y compris les meilleures pratiques pour les mises à jour, la synchronisation et l'automatisation.

Martin Donadieu

Martin Donadieu

Spécialiste du contenu

Gestion des versions dans les applications Capacitor

La gestion des versions est essentielle pour gérer les applications __CAPGO_KEEP_0__. Capacitor Les applications __CAPGO_KEEP_0__ 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 compteSuivi des mises à jour, permet le retraitement et garantit des déploiements stables.
  • Gestion sémantique des versionsUtilisez MAJOR.MINOR.PATCH pour indiquer les modifications majeures, les nouvelles fonctionnalités ou les correctifs de bogues. Synchronisation sur les plateformes Synchronisation sur les plateformes
  • Synchronisation sur les plateformes: Synchronisez les numéros de version package.json, iOS Info.plist, et Android build.gradle.
  • Automatisation: Automatisez les mises à jour avec des scripts npm et des outils CI/CD.
  • Mises à jour en temps réel: Les outils comme Capgo envoient des mises à jour à 95 % des utilisateurs en 24 heures.
  • Gestion de la bêta: Utilisez des canaux structurés pour les versions alpha, bêta et de production.

Comparaison Rapide

Fonctionnalité Objectif Exemple
Gestion de la Version Sémantique Suit les changements clairement 1.2.3 → 2.0.0
Synchronisation des Versions Synchronisation à travers les plateformes npx cap sync
Automatisation Accélère les mises à jour de version npm version patch
Mises à jour en temps réel Adoption rapide des utilisateurs Capgo’s 95% en 24 heures
Canaux de version bêta Phases de test contrôlées 1.3.0-beta.1

La balise de version simplifie Mise à jour d'applications, qui rend les utilisateurs heureux et permet aux développeurs de gérer les versions efficacement.

Comment configurer automatiquement votre Capacitor projet ⚡️

Capacitor Framework Documentation Website

Configuration de version dans Capacitor

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

Définir la version dans package.json

Le package.json Le fichier sert de source principale pour les 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"
  }
}

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 avec les versions précédentes.
  • Version de maintenance (x.x.3) : Corrige des bogues ou apporte des améliorations mineures.

Maintenir les versions des plateformes synchronisées

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

Plateforme Fichier de configuration Clé de version
iOS Info.plist CFBundleShortVersionString
Android build.gradle versionName
Web package.json version

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

En utilisant Capacitor CLI pour la gestion de version

La commande Capacitor CLI offre 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 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

Versionnement Sémantique (SemVer) utilise la forme MAJOR.MINOR.PATCH, où chaque partie indique un type spécifique de changement :

Version Component Objectif
MAJOR Introduit des modifications de rupture dans le API
MINOR Ajoute de nouvelles fonctionnalités qui restent compatibles avec les versions précédentes
PATCH Corrige les bogues ou améliore les performances sans rompre la compatibilité

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

When to Update Version Numbers

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

Type d'actualisation Quand utiliser Exemple de changement de version
Mise à jour majeure For breaking API changes or major UI redesigns 1.2.3 → 2.0.0
Mise à jour mineure Lors de l'introduction de nouvelles fonctionnalités ou de la mise en retrait de fonctionnalités 1.2.3 → 1.3.0
Mise à jour de patch Pour les correctifs de bogues ou les ajustements de performance mineurs 1.2.3 → 1.2.4

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

Voilà, passons maintenant à l'automatisation de ces mises à jour pour simplifier la gestion des versions.

Mise à jour de version Automatisée

Automatiser les mises à jour de version peut économiser du temps et réduire les erreurs dans votre projet Capacitor. Voici comment l'installer :

  1. Scripts de version NPM

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"
  }
}
  1. Intégration CI/CD
    Incorporate version updates into your CI/CD pipeline. Capgo supports tools like GitHub Actions, GitLab CI, et Jenkinsen faisant simple l'automatisation.

“@Capgo est un outil indispensable pour les développeurs cherchant à gagner en productivité en évitant les longues revues de bugs.” - 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 Capacitor sorties d'applications. 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é :

Composant de Tag Format Exemple
Version de Lancement v[MINEUR].[MINOR].[PATCH] v1.2.3
Lancement de la version bêta v[VERSION]-bêta.[NUMÉRO] v1.2.3-bêta.1
Candidat de version de sortie v[VERSION]-rc.[NUMÉRO] v1.2.3-rc.2

Intégration du numéro de build

Les numéros de build aident à suivre les builds individuels dans chaque version. Pour les deux iOS et Android, augmentez le numéro de build avec 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 de magasin 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 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"
  }
}
  1. Gestion 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.

  1. Avancement de la version

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

Étape Format de version Objectif
Cette version 1.3.0-alpha.1 Tests internes
Cette version 1.3.0-beta.1 Groupe de test externe
RC (Candidate de version de sortie) 1.3.0-rc.1 Dernières étapes de test avant la mise en production
Mise en production 1.3.0 Sortie publique

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.

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 efficacement.

Obtenir la Version avec Capacitor

Vous pouvez récupérer les détails de version en utilisant 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.

Mise en œuvre de l'interface de version

Voici un exemple d'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 version incluent :

Emplacement Objectif Mise en œuvre
Ecran de configuration Version complète et de construction Informations de version détaillées
Page d'informations sur le projet Affichage de version basique Numéro de version uniquement
Pied de page de l'application Affichage minimal Chaîne de version condensée

En plus de l'affichage des informations 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 garantit aux utilisateurs l'accès aux dernières fonctionnalités et corrections. 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]

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

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

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

Chaîne Type de mise à jour Public cible
Production Versions stables Tous les utilisateurs
Bêta Versions préalables Groupe de test
Langage cible : Français Correctifs d'urgence Utilisateurs affectés

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

Solutions de gestion de versions

Découvrons ensemble des solutions avancées pour gérer efficacement les versions d'applications.

Options de gestion de versions

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

Voici quelques fonctionnalités clés à rechercher :

Fonctionnalité Importance Impact
Mises à jour en temps réel Critique Minimise les retards causés par les commentaires de l'App Store
Sécurité Essentiel Protège les données de l'utilisateur et code l'intégrité
Analytique Important Mesure le succès des mises à jour et l'adoption des utilisateurs
Intégration CI/CD Utile Facilite les processus de déploiement
Efficacité de Coût Stratégique Influence la planification à long terme du budget

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

Capgo Fonctionnalités de Contrôle de Version

tableau de bord d'actualisation en direct Capgo

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

  • 23,5 millions d'actualisations réussies
  • 95 % des utilisateurs mis à jour en 24 heures
  • 82 % de taux de réussite mondial
  • 434ms average API response time worldwide

Voici un exemple de l'utilisation de Capgo pour la gestion 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 arrêté le support des mises à jour en temps réel pour les applications hybrides et @AppFlow est trop coûteux.” - Simon Flack [1]

Taille de l'équipe Solutions

Capgo propose des plans flexibles pour s'adapter à toutes les tailles d'équipe, ce qui permet une gestion de version scalable et efficace.

Taille de l'équipe Plan Caractéristiques clés
Développeur Solo Hébergement cloud de base Mises à jour en temps réel, 1 000 MAU
Petite équipe (2-5) Plan de créateur 10 000 MAU, 500 Go de bande passante
Équipe moyenne (6-20) Plan d'équipe 100 000 MAU, autorisations
Entreprise Tarification PAYG personnalisée Sans limite de MAU, support dédié

Pour les équipes plus grandes, 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

La compréhension de la gestion des versions est essentielle pour simplifier les processus de développement et de déploiement.

Principaux points clés

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

Avantage Impact Résultat
Mises à jour instantanées Révisions plus courtes Adoption des utilisateurs plus rapide [1]
Gestion de la version Meilleure code gestion Taux de réussite plus élevé [1]
Suivi des mises à jour Surveillance en temps réel Résolution accélérée des problèmes [1]
Contrôle de la distribution Déploiements ciblés Support multi-plateforme

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

Comment Commencer

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

  • Configurer le suivi des versions: Utilisez la versionnement semantique dans votre package.json fichier et intégrez les plugins nécessaires.
  • Ajoutez des contrôles d'actualisation : Mettez en œuvre des systèmes pour vérifier et suivre les mises à jour de version.
  • Configurez les canaux de distribution : Créez des environnements séparés pour la production, la bêta et le développement.

Enfin, considérez l'ajout d'un système d'actualisation en temps réel pour garantir que les déploiements soient à la fois rapides et sécurisés.

Continuez de la mise en œuvre de la balise de version dans les Capacitor Applications

Si vous utilisez la mise en œuvre de la balise de version dans les Capacitor Applications pour planifier le retrait et le contrôle de version, connectez-le avec les retraits pour les détails d'implémentation dans les retraits, la cible de version pour les détails d'implémentation dans la cible de version, Comportement de mise à jour pour les détails d'implémentation dans le Comportement de mise à jour, bundle pour les détails d'implémentation dans bundle, et Capgo Mises à jour en temps réel pour le flux de travail du produit dans Capgo Mises à jour en temps réel.

Mises à jour en direct pour les applications Capacitor

Lorsqu'un bug de la couche web est en ligne, expédiez la correction à travers Capgo au lieu d'attendre des jours pour l'approbation de la boutique d'applications. Les utilisateurs reçoivent la mise à jour en arrière-plan tandis que les modifications natives restent dans le chemin de revue normal.

Démarrer Maintenant

Dernières actualités de notre Blog

Capgo vous donne les meilleures informations dont vous avez besoin pour créer une application mobile véritablement professionnelle.