Comment changer le format de numérotation de build dans Visual Studio

Lors de la gestion d’une application .NET, l’un des défis techniques auxquels les développeurs sont souvent confrontés est la version de leur logiciel. Un système de versionnage convivial est crucial pour la communication, surtout lorsque les utilisateurs signalent des bugs ou des problèmes. Ce guide vous présentera les étapes nécessaires pour changer le format de numéro de version dans Visual Studio, le rendant ainsi plus simple et plus concis.

Le problème

Vous avez hérité d’une application .NET qui met automatiquement à jour son numéro de version à chaque build. Bien que l’automatisation soit généralement bénéfique, le format de versionnage actuel peut laisser à désirer. Par exemple, une chaîne de version comme 3.5.3167.26981 peut être assez encombrante pour les utilisateurs, surtout quand ils doivent y faire référence lors du dépannage.

Format souhaité

Votre objectif est de simplifier le processus de versionnage. Vous souhaitez un format plus facile à communiquer, tel que 3.5 (build 3198), où :

• Les versions majeure et mineure sont mises à jour manuellement.
• Le numéro de build s’incrémente automatiquement.
• L’incrément se produit uniquement durant le processus de build RELEASE.

La solution

Étape 1 : Localisez votre fichier Projet

La numérotation de version que vous souhaitez changer est généralement configurée dans un fichier projet, communément nommé AssemblyInfo.cs. Dans ce fichier, vous recherchez l’attribut de version d’assemblage, qui peut ressembler à ceci :

[assembly: AssemblyVersion("3.5.*")]

Le caractère * indique à Visual Studio d’assigner automatiquement les numéros de build et de révision.

Étape 2 : Codifiez le numéro de version

Pour personnaliser votre format de versionnage, remplacez la numérotation automatique par une chaîne codée en dur qui correspond à votre format souhaité :

[assembly: AssemblyVersion("3.5.3198.0")]

Voici un aperçu du format de version :

• Version majeure : 3
• Version mineure : 5
• Numéro de build : 3198 (Ceci sera généré automatiquement)
• Révision : Vous pouvez le définir à 0 ou à tout autre nombre selon votre préférence.

Étape 3 : Personnalisez pour les builds Debug et Release

Pour s’assurer que le numéro de build s’incrémente uniquement lors d’un build de release, vous pouvez utiliser des directives préprocesseur du compilateur. C’est là que cela devient un peu plus avancé, mais c’est un outil puissant.

Dans AssemblyInfo.cs, vous pouvez écrire un code conditionnel comme ceci :

#if DEBUG
[assembly: AssemblyVersion("3.5.0.0")]
#else
[assembly: AssemblyVersion("3.5.*")]
#endif

Cette configuration assure que :

• Lors d’un build DEBUG, la version reste statique.
• Lors d’un build RELEASE, le numéro de version sera mis à jour en fonction du système de build.

Conclusion

Changer le format de numérotation de build dans Visual Studio est un processus simple qui peut considérablement améliorer l’expérience utilisateur. En suivant ces étapes, vous pouvez créer une structure de versionnage qui est non seulement plus simple à communiquer pour les utilisateurs, mais également mieux alignée avec votre processus de développement.

En ajustant votre stratégie de versionnage, vous donnez à vos utilisateurs la possibilité de signaler efficacement les problèmes, renforçant ainsi la communication entre développeurs et utilisateurs.

Bonne programmation !