Cómo Cambiar el Formato de Numeración de Construcción en Visual Studio

Al gestionar una aplicación .NET, uno de los desafíos técnicos que los desarrolladores suelen enfrentar es el versionado de su software. Un sistema de versionado fácil de usar es crucial para la comunicación, especialmente cuando los usuarios reportan errores o problemas. Esta guía te introducirá a los pasos necesarios para cambiar el formato del número de versión en Visual Studio, haciéndolo más sencillo y conciso.

El Problema

Has heredado una aplicación .NET que actualiza automáticamente su número de versión con cada construcción. Si bien la automatización es generalmente beneficiosa, el formato actual de versionado puede dejar mucho que desear. Por ejemplo, una cadena de versión como 3.5.3167.26981 puede ser bastante engorrosa para que los usuarios la articulen, especialmente cuando necesitan hacer referencia a ella durante la resolución de problemas.

Formato Deseado

Tu objetivo es simplificar el proceso de versionado. Quieres un formato que sea más fácil de comunicar, como 3.5 (construcción 3198), donde:

• Las versiones mayor y menor se actualizan manualmente.
• El número de construcción se incrementa automáticamente.
• El incremento ocurre solo durante el proceso de construcción de la RELEASE.

La Solución

Paso 1: Localiza Tu Archivo de Proyecto

El numerado de versión que deseas cambiar generalmente se configura en un archivo de proyecto, comúnmente denominado AssemblyInfo.cs. En este archivo, estás buscando el atributo de versión de la asamblea, que puede verse algo así:

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

El carácter * le indica a Visual Studio que asigne automáticamente los números de construcción y revisión.

Paso 2: Codificar la Versión de Forma Estática

Para personalizar tu formato de versionado, reemplaza la versionado automático con una cadena codificada de forma estática que coincida con tu formato deseado:

[assembly: AssemblyVersion("3.5.3198.0")]

Aquí hay un desglose del formato de versión:

• Versión mayor: 3
• Versión menor: 5
• Número de construcción: 3198 (Este será generado automáticamente)
• Revisión: Puedes establecer esto en 0 o cualquier otro número según tu preferencia.

Paso 3: Personaliza para Construcciones de Debug vs. Release

Para asegurarte de que el número de construcción se incremente solo durante una construcción de release, puedes usar directivas de preprocesador del compilador. Aquí es donde las cosas se vuelven un poco más avanzadas, pero es una herramienta poderosa.

En AssemblyInfo.cs, puedes escribir código condicional como este:

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

Esta configuración asegura:

• Durante una construcción DEBUG, la versión permanece estática.
• Durante una construcción RELEASE, el número de versión se actualizará según el sistema de construcción.

Conclusión

Cambiar el formato de numeración de construcción en Visual Studio es un proceso directo que puede mejorar significativamente la experiencia del usuario. Siguiendo estos pasos, puedes crear una estructura de versionado que no solo sea más sencilla para que los usuarios se comuniquen, sino que también esté mejor alineada con tu proceso de desarrollo.

Al adaptar tu estrategia de versionado, empoderas a tus usuarios para que reporten problemas de manera efectiva, mejorando así la comunicación entre desarrolladores y usuarios.

¡Feliz codificación!