Balise de version dans les applications Capacitor

La balise de version est essentielle pour gérer les applications __CAPGO_KEEP_0__. Elle 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 : Capacitor Version Tagging in __CAPGO_KEEP_0__ Apps

• Learn the essentials of version tagging in __CAPGO_KEEP_0__ apps, including best practices for updates, synchronization, and automation.: Suivi des mises à jour, activation des retours en arrière et garantie des déploiements stables.
• Semantic Versioning: Utilisez MAJOR.MINOR.PATCH pour indiquer les changements de rupture, les nouvelles fonctionnalités ou les correctifs de bogues.
• Sync Across Platforms: Alignez les numéros de version dans package.json, iOS Info.plist, et Android build.gradle.
• Automation: : Automatisez les mises à jour avec npm scripts et outils CI/CD.
• Mises à jour en temps réel: Outils comme Capgo livrent des mises à jour à 95 % des utilisateurs en 24 heures.
• Gestion de la version bêta: Utilisez des canaux structurés pour les versions alpha, bêta et de production.

Comparaison rapide

La balise de version simplifie Mises à jour d'applicationsgarde 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 cohérente de la version sur tous les plateformes dans votre application Capacitor.

Définir la version dans package.json

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

{
  "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 modifications de rupture.
• Version mineure (x.2.x) : Ajoute de nouvelles fonctionnalités qui sont compatibles avec les versions précédentes.
• Version de correctif (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 toutes les plateformes pour un déploiement d'applications fluide. Chaque plateforme a son propre fichier de configuration pour la version :

Après mise à jour de la version dans __CAPGO_KEEP_0__ __CAPGO_KEEP_1__, utilisez la commande suivante pour synchroniser les changements avec les configurations de plateforme native : package.jsonL'outil __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ propose des commandes utiles pour gérer les versions :

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 risques de mésalignements. Suivre ces étapes vous aidera à maintenir une version correcte dans votre application.

The Capacitor CLI offers helpful commands to manage 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

Keeping your Capacitor CLI updated ensures compatibility with version-specific features and reduces potential mismatches. Following these steps will help you maintain proper versioning in your app.

Setup de la version sémantique

Bases de la version sémantique

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

Cet 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 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]

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

Automatisation des mises à jour 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 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"
  }
}

2. Intégration CI/CD
   Incorpore 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 à augmenter leur productivité en évitant les longues revues de bugfix.” - Bessie Cooper [1]

Méthodes de Tag de Version Git

Les tags de version Git sont une façon fiable de suivre les

__CAPGO_KEEP_0__ app releases releases de l'application Capacitor. Pour créer des balises claires et informatives, combinez la versionnement semantique 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 build

Les numéros de build aident à suivre les builds individuels au sein de 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 des magasins d'applications est identifiée de manière unique tout en maintenant la version claire 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 des builds bêta tandis que les utilisateurs de production reçoivent des versions stables.

3. Progression de version

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

Cette approche garantit un test exhaustif 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.

Récupérer 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.

Version UI Implementation

Voici un exemple de mise en œuvre 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 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:

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

Solutions de gestion de versions

Plongeons plus profondément dans les solutions avancées pour gérer efficacement les versions de l'application.

Options 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 dans les magasins d'applications et les mises à jour en direct.

Voici quelques fonctionnalités clés à rechercher :

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

Capgo Fonctionnalités de Contrôle de Version

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

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

Voici un exemple de la façon 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 arrêté le support des mises à jour en direct pour les applications hybrides et @AppFlow est trop coûteux.” - Simon Flack [1]

Solutions pour les Tailles d'Équipe

Capgo propose des plans flexibles pour s'adapter à toutes les tailles d'équipe, ce qui permet une gestion de version échelonnée 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 à la livraison continue à nos utilisateurs !” - Rodrigo Mantica [1]

Capgo comprend également un tableau de bord d'analytique pour suivre les taux d'adoption des versions 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

La compréhension de la balise de version est essentielle pour simplifier les processus de développement et de déploiement. Voici un rappel rapide des principes clés et des étapes à suivre pour commencer.

Principaux points clés

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.
• Ajouter des contrôles d'actualisation: 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, considérez l'ajout d'un système d'actualisation en temps réel pour s'assurer que les déploiements sont à la fois rapides et sécurisés.

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

Si vous utilisez La balise de version dans les applications Capacitor pour planifier le rollback et le contrôle de version, connectez-le à Rollbacks pour les détails d'implémentation dans Rollbacks, Version Ciblée pour les détails d'implémentation dans Version Ciblée, Comportement de Mise à Jour pour les détails d'implémentation dans Comportement de Mise à Jour, bundle pour les détails d'implémentation dans bundle, et Mises à Jour Capgo en Direct pour le flux de travail du produit dans les mises à jour en direct de Capgo.