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

Vous souhaitez simplifier les mises à jour d'applications et le contrôle de version? Les mises à jour d'applications et le contrôle de version? La versionnement sémantique (SemVer) avec Capgoles mises à jour Over-The-Air (OTA) de Capacitor facilite la gestion et la mise à jour de vos applications plus rapidement. Voici comment :

Bases de la versionnement semantique : Les versions utilisent la forme MAJOR.MINOR.PATCH:
- MAJOR: Pour les changements de rupture.
- MINOR: Pour les nouvelles fonctionnalités qui sont compatibles avec les versions précédentes.
- 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 mise en production 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.
Gérer les versions et les 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.
Processus 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 perturbations 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 Guide de configuration

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

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

Étapes d'initialisation initiales

Démarrer par l'installation du Capgo plugin de mise à jour:

npm install @capgo/capacitor-updater  
npx cap sync

Assurez-vous que votre capacitor.config.json le fichier utilise une 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 les emplacements suivants :

package.json (recherchez 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

Tableau de référence rapide :

Phase de configuration	Action de clé	Étape de vérification
Installation	Installer le plugin et synchroniser	Vérifier `package.json`
Configuration	Définir les numéros de version	Vérifier dans tous les fichiers
Initialisation	Se connecter avec la clé API	Tester l'état de la connexion
Construire	Créer le premier bundle	Confirmer le succès de l'upload

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 :

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 s'assure 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

Finalement, informez le plugin natif de l'état de la charge utile dans le fichier principal de votre application :

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

Cette configuration s'assure 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 des numéros de version

Capgo utilise la versionnement Sémantique (SemVer) pour gérer les versions des applications, sous la forme 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 qui restent compatibles.
Version de correctif (1.0.X): Augmentez le nombre PATCH pour les correctifs de bogues qui ne touchent pas la compatibilité.

Type de version	Quand incrémenter	Comportement d'actualisation automatique
Majeur (X.0.0)	Pour les changements de rupture API	Exige une approbation manuelle
Mineur (1.X.0)	Pour les nouvelles fonctionnalités	Configurable dans Capgo
Patch (1.0.X)	Pour les corrections de bogues	Généralement automatique

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

Version Control Guidelines

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 de production » (par exemple, 1.2.0) pour les versions stables.
- Ajoutez des canaux spécifiques aux plateformes (par exemple, « ios-hotfix » avec la version 1.2.1) lors du traitement d'issues spécifiques aux plateformes.
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 patch, tandis que les mises à jour mineures et majeures nécessitent une approbation manuelle.
Stratégie de Reversion de Version: Utilisez des 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 cohérence de la versionisation sur tous les canaux.

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

sbb-itb-f9944d2

Déploiement de Mises à Jour 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. Assurez-vous que la version suit le format SemVer (MAJOR.MINOR.PATCH) :

Correction de Bug: Augmentez le numéro de PATCH (par exemple, 1.0.1 → 1.0.2)
Nouvelle Fonctionnalité: Augmentez le numéro mineur (par exemple, 1.0.0 → 1.1.0)
Changement Important: Augmentez le numéro majeur (par exemple, 1.0.0 → 2.0.0)

Testez soigneusement votre build et confirmez que l'application se connecte au serveur en utilisant notifyAppReady.

Décidez ensuite de votre stratégie d'actualisation. Vous pouvez choisir parmi :

Mise à Jour Automatique: Appliquez automatiquement les exigences de version minimale.
Contrôle Manuel: Spécifiez des exigences de version exactes pour les mises à jour.
Channel-Based: Utilisez les canaux pour les tests et les déploiements étalés.

Capgo CLI Mise à jour des commandes

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

# 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 is a smart way to make hot code pushes (and not for all the money in the world like with @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.
Applique la mise à jour lors du prochain lancement.

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

“Nous pratiquons le développement agile et @Capgo est essentiel à la livraison continue à nos utilisateurs !”

Résolution de problèmes et conseils

Problèmes de gestion de version

La gestion de la versionnement semantique dans Capgo peut parfois compliquer les déploiements d'actualisation. Pour éviter de surécrire 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 sur false pendant le développement.
Désinstaller l'application.
La réinstaller avec la version corrigée.
Réactiver les mises à jour automatiques une fois tout stable.

Pour les mises à jour de version majeure, utilisez le disableAutoUpdateBreaking flag et écoutez l'événement majorAvailable pour gérer les mises à jour correctement :

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 la cohérence de la version et réduire les erreurs.

Contrôle de version d'équipe

Une fois les mises à jour individuelles 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” [4]

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

Définissez une branche comme le dépôt principal pour agir comme source de vérité.
Utilisez des canaux séparés Capgo pour les environnements de développement et de production.
Automatiser les téléchargements de versions via les pipelines CI/CD.
Documentez toutes les code modifications avec des messages de commit clairs et détaillés.

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

Environnement	Chaîne	Mise à jour automatique	Modèle de version
Développement	dev	Désactivé	0.x.x
Étape de pré-production	beta	Activé	x.x.x-beta
Production	stable	Activé	x.x.x

É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 :

Revenir à une version précédente de bundle stable.
Augmentez les numéros de version pour les nouveaux correctifs (remarque : les numéros de version ne peuvent pas être réutilisés après suppression) [2].
Vérifiez les mises à jour lors du démarrage de l'application pour vous assurer qu'elles fonctionnent comme prévu.

L'Capgo' 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]En outre, 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 semantique, 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 augmenté de 81 % d'efficacité. [1]Cet ensemble permet aux développeurs de déployer des mises à jour rapidement et de manière contrôlée, en évitant les retards des magasins d'applications.

Ici, ce que disent les développeurs :

“Nous avons déployé les mises à jour OTA de Capgo en production pour notre base d'utilisateurs de +5000. Nous constatons 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 version majeure, des nouvelles fonctionnalités et des correctifs de bogues. [5]. Cela est particulièrement utile pour les équipes gérant plusieurs mises à jour 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 semantique avec les mises à jour OTA de Capgo

Si vous utilisez Comment utiliser la versionnement semantique avec les mises à jour OTA de Capgo pour planifier le rollback et le contrôle de version, connectez-le avec Rollbacks pour les détails d'implémentation dans Rollbacks, Ciblage de Version pour les détails d'implémentation dans Ciblage de Version, 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 Capgo Mises à Jour en Direct pour le flux de travail du produit dans Capgo Mises à Jour en Direct.

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