How to Use Semantic Versioning with Capgo OTA Updates

Comment utiliser la versionnement sémantique avec les mises à jour OTA de __CAPGO_KEEP_0__ Voulez-vous simplifier les mises à jour de l'application et de contrôle de version ? Semantic Versioning (SemVer) associé à Capgoles mises à jour Over-The-Air (OTA) de Capacitor facilite la gestion

• et accélère la mise à jour des applications. Voici comment procéder : Les principes de base de la versionnement semantique : MAJOR.MINOR.PATCH:

  • Les versions utilisent la forme MAJOR :
  • Pour les modifications majeures . Pour de nouvelles fonctionnalités qui sont compatibles en arrière-plan.
  • PATCH : Pour les corrections de bogues.

• Pourquoi Utiliser SemVer avec Capgo ?

  • Une 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 dans capacitor.config.json et d'autres fichiers.
  3. Initialisez avec votre clé API.
  4. Utilisez Capgo CLI pour packager et télécharger les mises à jour.

• Gestion des Versions et des Canaux:

  • Utilisez des canaux séparés (par exemple, « beta » pour les tests, « production » pour les versions stables).
  • Contrôlez les politiques de mise à jour (mise à jour automatique des correctifs, approbation manuelle pour les changements majeurs).
  • Options de reversion pour les mises à jour échouées.

• Procédure de déploiement :

  • Mettez à jour les numéros de version en suivant les 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 de manière efficace.

Versionnement Sémantique | Améliorez votre niveau.

Capgo __CAPGO_KEEP_0__

Capgo Interface de tableau de bord de mise à jour en direct

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

Étapes d'initialisation de configuration : Capgo plugin de mise à jour:

npm install @capgo/capacitor-updater  
npx cap sync

Assurez-vous que votre capacitor.config.json context

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

HTML text fragment from a longer Capgo UI string (parent key `solutions_cordova_to_capacitor_ai_step2_body`). Page/area: Capgo solutions marketing page. Role: Website copy sentence. Seen in: page solutions/cordova-to-capacitor-ai.astro. Message key `solutions_cordova_to_capacitor_ai_step2_body` (Solutions Cordova To Capacitor Ai Step2 Body).

• package.json fichier utilise une forme de version sémantique : version Pour les anciens projets, mettez à jour les détails de version dans ces emplacements :
• android/app/build.gradle (cherchez le versionName)
• ios/App/App.xcodeproj/project.pbxproj champ) CURRENT_PROJECT_VERSION)

Once configured, initialize Capgo with your API key:

npx @capgo/cli@latest init YOUR_API_KEY

(mettez à jour

Intégration de Contrôle de Version

Capgo fonctionne bien avec les plateformes CI/CD, ce qui rend les mises à jour automatiques simples. Les plateformes prises en charge incluent :

• GitHub Actions
• GitLab CI
• Azure DevOps
• Jenkins
• CircleCI

Si vous travaillez sur un 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écrira 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.

Utilisation de la versionnement sémantique avec Capgo

Gestion du numéro de version

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

• Version majeure (X.0.0): Augmentez le nombre MAJOR pour les changements qui brisent la compatibilité.
• Version mineure (1.X.0): Augmentez le nombre MINOR pour de nouvelles fonctionnalités compatibles.
• Version de correction (1.0.X): Augmentez le numéro de 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 vous assurer d'une mise à jour plus fluide à travers 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 Canal: Organisez votre processus de déploiement en créant des canaux séparés pour les tests et la production. Par exemple :

  • Utilisez un canal « beta » (par exemple, 1.2.0-beta) pour tester de nouvelles fonctionnalités.
  • Conservez un canal « production » (par exemple, 1.2.0) pour les versions stables.
  • Ajoutez des canaux spécifiques à la plateforme (par exemple, « ios-hotfix » avec la version 1.2.1) lorsque vous adressez des problèmes spécifiques à la plateforme.

• Configuration de la Politique d'Actualisation: Contrôlez comment les mises à jour sont appliquées à l'aide des options de configuration de Capgo . Par exemple :

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

  Cette configuration garantit que les utilisateurs reçoivent automatiquement les mises à jour de correctif, tandis que les mises à jour mineures et majeures nécessitent une approbation manuelle.

• Stratégie de Reversion de Version: Utilisez les identificateurs de pré-version pour maintenir des options de reversion claires. Cette approche vous permet de revenir à une version précédente si des problèmes se produisent, tout en maintenant la versionnage cohérent à travers tous les canaux.

Ce sont les meilleures pratiques qui facilitent la gestion des mises à jour, la test de nouvelles fonctionnalités et la maintenance de la stabilité dans le processus de déploiement de votre application.

sbb-itb-f9944d2

Déploiement d'Update OTA

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

Préparation de la Mise à Jour

Commencez par mettre à jour la version dans package.json et capacitor.config.json__CAPGO_KEEP_0__.config.json

• Bug Fix: Augmentez le numéro PATCH (par exemple, 1.0.1 → 1.0.2)
• New Feature: Augmentez le numéro MINOR (par exemple, 1.0.0 → 1.1.0)
• Breaking Change: Augmentez le numéro MAJOR (par exemple, 1.0.0 → 2.0.0)

Thoroughly test your build and confirm the app communicates with the server using notifyAppReady.

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

• Auto-Update: Appliquez automatiquement les exigences de version minimale.
• Contrôle Manuel: Spécifiez des exigences de version exacte pour les mises à jour.
• Basé sur le Canal: Utilisez les canaux pour les tests et les déploiements étalés.

Capgo CLI Commandes de Mise à Jour

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

# 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 de bout en bout et une gestion de clés sûre.

“@Capgo est une façon intelligente de faire des pushs chauds code (et pas pour tout l'argent du monde comme avec @AppFlow) 🙂”

Une fois déployée, vous pouvez surveiller les mises à jour à travers le tableau de bord de Capgo. Les mises à jour atteignent généralement les utilisateurs dans les minutes qui suivent leur ouverture de l'application. Le processus fonctionne comme suit :

• 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.
• Appliquez l'actualisation lors du prochain démarrage.

Pour les déploiements à l'échelle 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

Gestion des versions

Gestion de la versionnement sémantique 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 actualisation échoue, voici ce que vous pouvez faire :

• Configurez autoUpdate à false context : Page/zone : Page de produit d'actualisations en direct. Rôle : Étiquette de navigation ou élément de l'IU court. Clé de message `live_update_dynamic_label_to` (Étiquette dynamique d'actualisation en direct à).
• pendant le développement.
• Réinstaller avec la version corrigée.
• Réactiver les mises à jour automatiques une fois que tout est stable.

Pour les mises à jour de version majeure, utilisez la disableAutoUpdateBreaking flag et écoutez l'événement pour gérer les mises à jour correctement : majorAvailable En combinant ces configurations avec de bonnes pratiques d'équipe, vous pouvez maintenir la cohérence de la version et réduire les erreurs.

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

Contrôle de Version Équipe

Une fois que les mises à jour individuelles sont gérées, il est crucial pour les équipes d'établir des pratiques de contrôle de version solides.

« Tester chaque changement avant de le fusionner avec le dépôt principal renforcera la stabilité et évitera des erreurs coûteuses »

Voici quelques méthodes pour s'assurer de la cohérence : [4]

Définir une branche comme le

• dépôt principal Reinstaller avec la version corrigée. fournir la source de vérité.
• Utilisez des canaux Capgo séparés pour les environnements de développement et de production.
• Automatiser les téléchargements de versions via les pipelines CI/CD.
• Documentez toutes les modifications code avec des messages de commit clairs et détaillés.

Pour les équipes plus importantes, la matrice suivante de gestion de version peut aider à organiser les mises à jour :

Étapes de récupération de mise à jour

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 stable précédente.
2. Augmentez les numéros de version pour tout nouveau correctif (remarque : les numéros de version ne peuvent pas être réutilisés après suppression) [2].
3. Vérifiez les mises à jour pendant le démarrage de l'application pour vous assurer qu'elles fonctionnent comme prévu.

L'Capgo's mise à jour est conçue 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 sont devenus 81 % plus efficaces. [1]Cet ensemble permet aux développeurs de pousser des mises à jour rapidement et de manière contrôlée, en évitant ainsi les retards des magasins d'applications.

Ici, voici ce que disent les développeurs :

“Nous avons déployé les mises à jour OTA de Capgo In 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 qui suivent la mise à jour OTA déployée sur @Capgo.” - colenso [1]

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

Capgo’s Une solution chiffrée, intégrée avec les outils CI/CD, est également abordable - elle réduit 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 les mises à jour OTA de Capgo

Si vous utilisez Comment utiliser la versionnement sémantique avec les mises à jour OTA de Capgo à planifier le retrait et le contrôle de version, connectez-l’avec Rollbacks pour les détails d'implémentation dans Rollbacks, Version Cible 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. Message clé `solutions_version_targeting_title` (Titre de la version des solutions). | Page/zone : Page de marketing de solutions Capgo. Rôle : Étiquette de navigation ou élément de menu court. Vu dans : page solutions/version-targeting.astro. Message clé `solutions_version_targeting` (Version ciblée des solutions). pour les détails d'implémentation dans Version Cible, Comportement de Mise à Jour context Capgo Live Updates for the product workflow in Capgo Live Updates.