Comment utiliser la versionnement sémantique avec les mises à jour OTA de Capgo

Vous souhaitez simplifier app updates et le contrôle de version ? La versionnement sémantique (SemVer) associée à CapgoLes mises à jour Over-The-Air (OTA) de fait la gestion Capacitor apps easier and faster. Here’s how:

• Bases de la versionnement sémantique : Les versions utilisent la forme MAJOR.MINOR.PATCH:

  • MAJOR : Pour les modifications de rupture.
  • MINOR : Pour les nouvelles fonctionnalités compatibles à l'envers.
  • PATCH : Pour les correctifs de bogues.

• Pourquoi Utiliser SemVer avec Capgo ?

  • Communication claire sur les mises à jour.
  • Une gestion plus intelligente des versions.
  • Éviter les conflits de dépendances.
  • Planification de lancement organisée.

• Capgo Configuration Étapes :

  1. Installez le plugin de mise à jour de Capgo.
  2. Configurez la version de votre application en capacitor.config.json et d'autres fichiers.
  3. Initialisez avec votre clé de API.
  4. Use Capgo CLI charger et télécharger les mises à jour.

• Gérer les Versions et les Canaux:

  • Utilisez des canaux séparés (par exemple, « beta » pour les tests, « production » pour les versions stables).
  • Utilisez des canaux séparés (par exemple, « beta » pour les tests, « production » pour les versions stables).
  • Options de reversion pour les mises à jour échouées.

• Processus de déploiement :

  • Mise à jour des numéros de version conformément aux règles de SemVer.
  • Testez soigneusement avant de déployer.
  • Utilisez les commandes CLI pour télécharger et distribuer les mises à jour.

Capgo garantit que les mises à jour atteignent les utilisateurs rapidement et de manière fiable, avec des outils pour gérer les interruptions et maintenir la stabilité. Parfait pour les équipes utilisant des workflows CI/CD pour automatiser les mises à jour.

Conseil rapide : Testez toujours les mises à jour et utilisez les canaux pour gérer les déploiements étalés efficacement.

Versionnement Sémantique | Améliorez votre niveau.

Capgo Setup Guide

Voici comment configurer Capgo pour gérer les mises à jour OTA et le contrôle de version avec facilité.

Étapes de configuration initiale

Commencez par installer le Capgo plugin de mise à jour:

npm install @capgo/capacitor-updater  
npx cap sync

Assurez-vous que votre capacitor.config.json fichier utilise un format de version sémantique :

{ 
  "appId": "com.example.app", 
  "appName": "My App", 
  "version": "1.0.0" 
}

Pour les anciens projets, mettez à jour les détails de version dans ces emplacements :

• package.json (cherchez le version champ)
• android/app/build.gradle (mettez à jour versionName)
• ios/App/App.xcodeproj/project.pbxproj (mettez à jour CURRENT_PROJECT_VERSION)

Une fois configuré, initialisez Capgo avec votre clé API :

npx @capgo/cli@latest init YOUR_API_KEY

Table de référence rapide :

Intégration de contrôle de version

Capgo fonctionne bien avec les plateformes CI/CD, ce qui permet mises à jour automatiques Les plateformes suivantes sont prises en charge :

• GitHub Actions
• Azure DevOps
• Azure DevOps
• Jenkins
• CircleCI

Si vous travaillez sur le développement local, vous pouvez désactiver les mises à jour automatiques en ajoutant cela à votre configuration :

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

Cela garantit que Capgo ne surécrit pas vos modifications locales. Une fois votre configuration prête, téléchargez votre première version :

npx @capgo/cli@latest bundle upload  
npx @capgo/cli@latest channel set production -s default

Enfin, informez le plugin natif de l'état de la mise en bundle dans votre fichier principal d'application :

import { CapacitorUpdater } from '@capgo/capacitor-updater';  
CapacitorUpdater.notifyAppReady();

Cette configuration garantit que votre application est prête pour des déploiements OTA lisses et une gestion de version.

Gestion de la version avec Capgo

Gestion de la version

Capgo utilise la versionnement sémantique (SemVer) pour gérer les versions d'applications, sous la forme MAJOR.MINOR.PATCHVoici comment cela fonctionne :

• Version majeure (X.0.0): Augmentez le nombre MAJOR pour les modifications qui brisent la compatibilité.
• Version mineure (1.X.0): Incrémentez le numéro mineur pour de nouvelles fonctionnalités compatibles.
• Version de correction (1.0.X)Augmentez le numéro PATCH pour les correctifs qui ne touchent pas à la compatibilité.

En suivant les règles de SemVer, vous pouvez simplifier la gestion des versions et assurer des mises à jour plus fluides dans vos canaux de déploiement.

Directives de Contrôle de Version

Capgo vous permet de gérer efficacement vos déploiements en configurant des canaux distincts pour différentes étapes de votre flux de travail.

• Gestion de Version par CanalOrganisez votre processus de déploiement en créant des canaux séparés pour le test et la production. Par exemple :

  • Utilisez un « canal de bêta » (par exemple, 1.2.0-bêta) pour tester de nouvelles fonctionnalités.
  • Conservez un « canal de production » (par exemple, 1.2.0) pour les versions stables.
  • Ajoutez des canaux spécifiques au plateau (par exemple, « ios-hotfix » avec la version 1.2.1) lors de l'abordage des problèmes spécifiques au plateau.

• Politique de mise à jour: Contrôlez comment les mises à jour sont appliquées à l'aide des options de configuration de Capgo.

  {
    "plugins": {
      "CapacitorUpdater": {
        "disableAutoUpdate": "minor"
      }
    }
  }

  This setup ensures that users automatically receive patch updates, while minor and major updates require manual approval.

• Stratégie de Reversion de Version: Use pre-release identifiers to maintain clear rollback options. This approach allows you to revert to a previous version if problems occur, while keeping versioning consistent across all channels.

Ces meilleures pratiques facilitent la gestion des mises à jour, les tests de nouvelles fonctionnalités et l'entretien de la stabilité dans le processus de déploiement de votre application.

sbb-itb-f9944d2

sbb-itb-f9944d2

Une fois votre configuration de gestion de version prête, suivez ces étapes pour déployer des mises à jour OTA efficacement.

Préparation de mise à jour

Préparation de la mise à jour package.json et capacitor.config.jsonAssurez-vous que la version suit le format SemVer (MAJOR.MINOR.PATCH) :

• Correction: Incrémentez le numéro de PATCH (par exemple, 1.0.1 → 1.0.2)
• New Feature: Incrémentez le numéro de MINOR (par exemple, 1.0.0 → 1.1.0)
• Changement majeur: Incrémentez le numéro de MAJOR (par exemple, 1.0.0 → 2.0.0)

Testez soigneusement votre build et confirmez que l'application se communique avec le serveur en utilisant notifyAppReady.

Ensuite, déterminez votre stratégie d'actualisation. Vous pouvez choisir entre :

• Auto-Update: Appliquez automatiquement les exigences de version minimale.
• Contrôle manuelSpécifiez des exigences de version exactes pour les mises à jour.
• Channel-Based: Utilisez les canaux pour les tests et les déploiements étalés.

Commandes de mise à jour Capgo CLI

Utilisez Capgo’s CLI pour déployer votre mise à jour avec facilité. Voici comment faire :

# Initialize Capgo in your project
npx @capgo/cli@latest init [apikey]

# Upload your update bundle
npx @capgo/cli bundle upload [appId]

# Add a new distribution channel
npx @capgo/cli channel add [channelName] [appId]

Capgo garantit un déploiement sécurisé avec une encryption à la fin-à-fin et une gestion de clés sûre.

“@Capgo est une façon intelligente de faire des pushs chauds code (et pas pour tous les euros du monde comme avec @AppFlow) 🙂”

Once deployed, you can monitor updates through Capgo’s dashboard. Updates typically reach users within minutes after they open the app. The process works like this:

• L'application vérifie les mises à jour.
• Télécharge la mise à jour en arrière-plan.
• Marque la nouvelle version comme active lorsque l'utilisateur quitte l'application.
• Applique la mise à jour lors du prochain lancement.

Pour les déploiements d'entreprise, vous pourriez vouloir intégrer l'automatisation CI/CD.

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

Résolution de problèmes et conseils

Problèmes de gestion de version

Gérer la versionnement semantique dans Capgo peut parfois compliquer les déploiements d'actualisations. Pour éviter d'effacer votre travail de développement, configurez les éléments suivants dans votre capacitor.config.json fichier :

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

Si une mise à jour échoue, voici ce que vous pouvez faire :

• Définir autoUpdate à false pendant le développement.
• Désinstallez l'application.
• Réinstallez-l’avec la version corrigée.
• Réactivez les mises à jour automatiques une fois que tout est stable.

For major version updates, use the disableAutoUpdateBreaking flag et écoutez l'événement pour gérer les mises à jour correctement : majorAvailable event to handle updates properly:

CapacitorUpdater.addListener('majorAvailable', (info) => {
  console.log(`Major update available: ${info.version}`);
  // Add your update prompt logic here
});

En combinant ces configurations avec de bonnes pratiques d'équipe, vous pouvez maintenir une cohérence de version et réduire les erreurs.

Contrôle de version d'équipe

« Testez chaque changement avant de le fusionner avec le référentiel principal pour renforcer la stabilité et éviter des erreurs coûteuses »

Tester chaque changement avant de le fusionner avec le référentiel principal renforcera la stabilité et évitera des erreurs coûteuses. [4]

Voici quelques méthodes pour garantir la cohérence :

• Définissez une branche comme le répertoire principal qui servira de référence.
• Utilisez des canaux Capgo séparés pour les environnements de développement et de production.
• Automate version uploads via CI/CD pipelines.
• Documentez toutes les code modifications avec des messages de commit clairs et détaillés.

Pour les équipes plus importantes, le tableau suivant de gestion de version peut aider à organiser les mises à jour.

Mise à jour de récupération

Même avec des précautions, les mises à jour peuvent échouer. Si cela se produit, suivez ces étapes de récupération :

1. Revenir à une version précédente stable du bundle.
2. Augmenter les numéros de version pour les correctifs nouveaux (remarque : les numéros de version ne peuvent pas être réutilisés après suppression) [2].
3. Verify updates during app startup to ensure they work as expected.

Le correcteur de Capgo est conçu pour gérer les interruptions. Par exemple, si le serveur est inaccessible ou une mise à jour est supprimée, l'application continue à fonctionner normalement. [3]De plus, les requêtes réseau échouées sont automatiquement réessayées lors du lancement de l'application suivant. [3]Cette résilience intégrée minimise les temps d'arrêt et assure des opérations plus fluides.

Résumé

La versionnement sémantique, combinée à Capgo, a rendu les mises à jour OTA pour les applications Capacitor plus efficaces. Avec 947,6 millions de mises à jour délivrées et 1 400 applications de production utilisant ce système [1], les processus de déploiement ont été 81 % plus efficaces. [1]Cet ensemble permet aux développeurs de pousser les mises à jour rapidement et de manière contrôlée, en évitant les retards des magasins d'applications.

Voici ce que disent les développeurs :

“Nous avons déployé Capgo mises à jour OTA dans la production pour notre base d'utilisateurs de +5000. Nous observons une opération très fluide presque tous nos utilisateurs sont à jour dans les minutes suivant la mise à jour OTA déployée sur @Capgo.” - colenso [1]

Le système de versionnage MAJOR.MINOR.PATCH facilite la communication des changements majeurs, des nouvelles fonctionnalités et des corrections de bogues. [5]. Cela est particulièrement utile pour les équipes gérant plusieurs releases chaque semaine à travers la plateforme de Capgo.

Capgo’s solution chiffrée, intégrée avec les outils CI/CD, est également abordable - en réduisant les coûts de jusqu'à 26 100 $ sur cinq ans [1]. Ses canaux personnalisables assurent que les mises à jour atteignent les bons utilisateurs au bon moment.

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

Continuez à partir de Comment utiliser la versionnement sémantique avec Capgo mises à jour OTA

Si vous utilisez Comment utiliser la versionnement sémantique avec les mises à jour OTA de Capgo pour planifier le rollback et le contrôle de version, connectez-l’avec 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 en Temps Réel de Capgo for the product workflow in Capgo Live Updates.