Passer au contenu principal

Tag de version dans les applications Capacitor

Apprenez les bases du tag de version dans les applications Capacitor, y compris les meilleures pratiques pour les mises à jour, la synchronisation et l'automatisation.

Tag de version dans les applications Capacitor

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

  • Pourquoi cela compte: Suivi des mises à jour, permet le retraitement et garantit des déploiements stables.
  • Numérotation Sémantique: Utilisez MAJOR.MINOR.PATCH pour indiquer les modifications importantes, les nouvelles fonctionnalités ou les correctifs de bogues.
  • Synchronisation sur les plateformes: Alignez les numéros de version sur package.jsoniOS Info.plist, Android build.gradle.
  • et Automatisation: Automatiser les mises à jour Avec des scripts et des outils CI/CD npm.
  • Mises à jour en temps réelLes outils comme __CAPGO_KEEP_0__ Capgo Fournir des mises à jour à 95 % des utilisateurs en 24 heures.
  • Gestion des versions bêta: Utilisez des canaux structurés pour les versions alpha, bêta et de production.

Comparaison rapide

Caractéristique Objectif Exemple
Numérotation Sémantique Suit les changements clairement 1.2.3 → 2.0.0
Sync Versions Aligner sur 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 bêta Phases de test contrôlées 1.3.0-beta.1

La numérotation de version simplifie Mises à jour d'applicationsgarde les utilisateurs heureux, et permet aux développeurs de gérer les versions efficacement.

Comment configurer automatiquement votre Capacitor Documentation du framework __CAPGO_KEEP_0__

Capacitor Framework Documentation Website

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

Follow these steps to ensure consistent version management across all platforms in your Capacitor app.

Le package.json

fichier sert de source principale pour les détails de version de votre application. Voici un exemple de comment l'installer : package.json __CAPGO_KEEP_0__ est un produit de Capgo.

{
  "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 correction (x.x.3) : Corrige des bogues ou apporte des améliorations mineures.

Maintenir les versions de plateforme en accord

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 :

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.jsonUtilisez la commande suivante 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

Mettre à jour 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 versionnement sémantique (SemVer) utilise la forme MAJOR.MINOR.PATCHoù chaque partie indique un type spécifique de changement :

Composant de version MAJOR
Introduit des changements de rupture dans le __CAPGO_KEEP_0__ Introduces breaking changes to the API
MINOR Ajoute de nouvelles fonctionnalités compatibles avec les versions précédentes
PATCH Répare les bogues ou améliore les performances sans briser la compatibilité

Ce système permet aux développeurs de communiquer clairement les mises à jour tout en préservant la compatibilité entre les versions d'application. Par exemple, passer de 1.2.3 à 2.0.0 indique des mises à jour majeures 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 :

Type de mise à jour 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 Mise à jour mineure lors de l'introduction de nouvelles fonctionnalités ou de la marquage de fonctionnalités comme obsolètes 1.2.3 → 1.3.0
Mise à jour de patch Mise à jour de patch pour les correctifs de bogues ou les ajustements de performances mineurs 1.2.3 → 1.2.4

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

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

Mise à jour automatique de version

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 de 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
    Intégrer 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 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 balises de version

Balises de version Git

Les étiquettes de version Git sont un moyen fiable de suivre les mises à jour de votre CapacitorLes étiquettes de version doivent être claires et informatives.

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 d'étiquetage standardisé :

Étiquette du composant Format Exemple
Version de mise en production v[MAJOR].[MINOR].[PATCH] v1.2.3
Version bêta v[VERSION]-beta.[NUMBER] v1.2.3-beta.1
Candidat de version v[VERSION]-rc.[NUMBER] v1.2.3-rc.2

Intégration du numéro de build

Les 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 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 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

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"
  }
}
  1. 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 des builds bêta tandis que les utilisateurs de production reçoivent des versions stables.

  1. Progression de version

Étape

Format de version Objectif Alpha
1.3.0-alpha.1 Test interne Bêta
Contrôle de l'accès des utilisateurs 1.3.0-beta.1 Groupe de test externe
RC (Candidate de version) 1.3.0-rc.1 Dernière étape de test avant la mise en production
Production 1.3.0 Mise en production publique

Cette approche garantit une test complète et des transitions fluides entre les différentes étapes de développement, tout en maintenant la traçabilité 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 efficacement les mises à jour.

Récupérer 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 de présentation 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 la présentation 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 communs pour afficher les détails de la version incluent :

Emplacement Objectif Context : Page/zone : Site web de marketing Capgo. Rôle : Étiquette de navigation ou élément de l'interface utilisateur court. Clé de message `subprocessors_table_purpose` (Objectif de la table des sous-traitants).
Mise en œuvre Écran de paramètres Version complète et de construction
Informations de version détaillées 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 assure 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]

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, le système de canaux de Capgo permet de contrôler la distribution des mises à jour :

Canal Type d'actualisation Public cible
Production Sorties stables Tous les utilisateurs
Bêta Versions préalables Groupe de test
Critique Réparations 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 version

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

Options de gestion de version

Lorsque vous sélectionnez les outils de contrôle de version, il est important de vous concentrer sur ceux qui simplifient les mises à jour, sécurisent votre code, et supportent à la fois les lancements de magasins d'applications et les mises à jour en direct.

Voici quelques fonctionnalités clés à prendre en compte :

Fonctionnalité Importance Impact
Mises à jour en temps réel Critique Réduit les temps d'attente causés par les révisions des magasins d'applications
Sécurité Essentiel Protège les données de l'utilisateur et code l'intégrité
Analytiques Important Mesure le succès des mises à jour et l'adoption de l'utilisateur
Intégration CI/CD Utile Améliore les processus de déploiement
Économie de coûts Stratégique Influence la planification à long terme du budget

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

Capgo Soumettre un PR à Capgo

Capgo Live Update Dashboard Interface

Capgo Interface de Tableau de bord de Mise à Jour en Direct

  • __CAPGO_KEEP_0__ fournit des capacités de gestion de version robustes, notamment :
  • 23,5 millions de mises à jour réussies
  • 95 % des utilisateurs mis à jour en 24 heures
  • 434ms average API response time worldwide

434 ms de temps de réponse moyen de Capgo dans le monde entier

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

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

“Nous essayons actuellement @__CAPGO_KEEP_0__ depuis que Appcenter a cessé de proposer des mises à jour en direct pour les applications hybrides et @AppFlow est trop coûteux.” - Simon Flack

Capgo propose des plans flexibles pour s'adapter à toutes les tailles d'équipe, ce qui rend la gestion des versions échelle et efficace.

Taille de l'équipe Plan Fonctionnalités clés
Développeur solo Hébergement cloud de base Mises à jour en direct, 1 000 MAU
Petite équipe (2-5) Plan Maker 10 000 MAU, 500 Go de bande passante
Moyenne équipe (6-20) Plan d'équipe 100 000 MAU, permissions
Entreprise Entreprise Entreprise

For larger teams, Capgo’s channel system enables precise control over version deployment:

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

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

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

Capgo also includes an analytics dashboard to monitor version adoption rates and detect potential issues early. With built-in encryption and customizable hosting options, teams can maintain security while scaling their deployment workflows.

Pour les équipes plus importantes, le système de canal de __CAPGO_KEEP_0__ permet un contrôle précis sur la mise en production des versions :

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

__CAPGO_KEEP_0__ comprend également un tableau de bord d'analyse pour surveiller 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

Principaux points à retenir : Version tagging 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 Durées de revue plus courtes Adoption par les utilisateurs plus rapide [1]
Contrôle de version Mise en œuvre de code plus efficace Taux de réussite plus élevés [1]
Suivi des mises à jour Suivi en temps réel Résolution des problèmes plus rapide [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 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 et intégrez les plugins nécessaires.
  • Ajouter des vérifications de mise à jour: Mettez en place des systèmes pour vérifier et suivre les mises à jour de version.
  • Configurer 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 temps réel pour garantir que les déploiements soient à la fois rapides et sécurisés.

Continuez à partir de la mise en version dans les applications Capacitor

Si vous utilisez La mise en version dans les applications Capacitor Pour planifier le rollback et le contrôle de version, connectez-l’à 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 de 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 mise en version des solutions). | Page/zone : Page de marketing de 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` (Mise en version des solutions). pour les détails d'implémentation dans La cible de version, Le comportement de mise à jour pour les détails d'implémentation dans Le comportement de mise à jour, et le paquet pour les détails d'implémentation dans le 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

Quand un bug de 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 la voie de revue normale.

assistance humaine de Martin

Commencez maintenant

Dernières actualités de notre Blog

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