C-Sharp Visual Studio Versioning

Mettez à jour automatiquement votre numéro de version dans Visual Studio avec facilité

Gérer les numéros de version dans les applications logicielles est crucial pour suivre les fonctionnalités, les corrections et les mises à jour. Lorsque vous développez des applications dans Visual Studio, vous pourriez avoir besoin d’incrémenter automatiquement le numéro de version pour chaque compilation. Dans cet article, nous allons explorer comment atteindre cela efficacement pour votre application, en particulier si vous utilisez des versions comme Visual Studio 2005/2008.

Comprendre le format du numéro de version

Tout d’abord, clarifions ce que nous entendons par le format du numéro de version. Un numéro de version typique suit la structure Majeur.Mineur.Build.Révision. Par exemple, dans le numéro de version 1.1.38, les segments peuvent être interprétés comme suit :

  • Majeur : Changements significatifs qui peuvent ne pas être rétrocompatibles.
  • Mineur : Améliorations rétrocompatibles.
  • Build : Incrémenté pour chaque nouvelle compilation.
  • Révision : Indique les corrections de bogues.

Dans .NET en particulier, il est important de noter que le numéro de Build est en fait le troisième chiffre, contrairement aux attentes de certains développeurs.

Le défi : Configurer l’incrémentation automatique

Vous pourriez rencontrer un problème avec l’utilisation de 1.0.* ou 1.0.0.* pour les numéros de build, car ces configurations remplacent généralement les numéros de révision et de build par un horodatage, ce qui n’est pas idéal pour le suivi. Vous pourriez également rencontrer des problèmes lorsque votre application dispose d’un fichier de configuration. Lorsque la version de l’assembly change, vos paramètres pourraient être réinitialisés par défaut, car votre application peut rechercher le fichier de configuration dans un autre répertoire.

La solution : Tâche AssemblyInfo

Pour mettre à jour automatiquement votre numéro de version, vous pouvez utiliser la Tâche AssemblyInfo. Cette tâche peut être configurée spécifiquement pour incrémenter le numéro de build pour vous. Voici comment configurer cela :

  1. Installez la Tâche AssemblyInfo : Vous pouvez trouver la Tâche AssemblyInfo ici. Cette tâche fait partie des scripts MSBuild.

  2. Configurez la tâche : Cela nécessite un peu de configuration mais automatisera le processus de versionnement. Consultez la documentation de la tâche pour obtenir des conseils sur les options de configuration.

Considérations importantes

Avant de mettre cela en œuvre, gardez à l’esprit deux limites importantes :

  1. Limites de numéros de version : Chacun des quatre nombres de la chaîne de version a une limite maximale de 65535. Cette limite découle de l’architecture de Windows et ne peut pas être modifiée. Pour plus d’informations, vous pouvez consulter cet article de blog MSDN.

  2. Intégration avec Subversion : Si vous utilisez Subversion, vous pourriez avoir besoin d’apporter des ajustements spécifiques pour vous intégrer avec la Tâche AssemblyInfo. Vous pouvez en apprendre davantage à ce sujet ici.

Comment récupérer le numéro de version

Une fois votre Tâche AssemblyInfo correctement configurée et exécutée, récupérer le numéro de version devient simple. Voici un extrait de code qui montre comment accéder au numéro de version et le formater :

Version v = Assembly.GetExecutingAssembly().GetName().Version;
string About = string.Format(CultureInfo.InvariantCulture, @"VotreApp Version {0}.{1}.{2} (r{3})", v.Major, v.Minor, v.Build, v.Revision);

Cet extrait de code vous aidera à afficher le numéro de version de manière programmatique dans votre application, facilitant ainsi aux utilisateurs le signalement de problèmes ou de demandes de mise à jour.

Conclusion : Rationalisez votre gestion des versions

Gérer les numéros de version est un aspect essentiel du développement logiciel. En mettant en œuvre la Tâche AssemblyInfo dans Visual Studio, vous pouvez automatiser le processus d’incrémentation de version, garantissant ainsi que les utilisateurs et les développeurs disposent d’un suivi de version cohérent. Cette approche permet non seulement de gagner du temps, mais aussi d’améliorer la communication entre les utilisateurs et les développeurs concernant les mises à jour et les corrections logicielles.

Maintenant que vous avez une compréhension claire de la manière de configurer cela, vous pouvez procéder en toute confiance et améliorer votre stratégie de contrôle de version !

N’hésitez pas à partager votre expérience ou les défis rencontrés lors de la configuration de cela dans les commentaires ci-dessous !