Visual Studio

Como Alterar o Formato de Numeração de Build no Visual Studio

Ao gerenciar uma aplicação .NET, um dos desafios técnicos que os desenvolvedores frequentemente enfrentam é a versionamento de seu software. Um sistema de versionamento amigável é crucial para a comunicação, especialmente quando os usuários relatam bugs ou problemas. Este guia irá apresentar as etapas necessárias para mudar o formato do número da versão no Visual Studio, tornando-o mais simples e conciso.

O Problema

Você herdou uma aplicação .NET que atualiza automaticamente seu número de versão a cada build. Embora a automação geralmente seja benéfica, o formato atual de versionamento pode deixar a desejar. Por exemplo, uma string de versão como 3.5.3167.26981 pode ser bastante complicada para os usuários articularem, especialmente quando precisam referenciá-la durante a solução de problemas.

Formato Desejado

Seu objetivo é simplificar o processo de versionamento. Você deseja um formato que seja mais fácil de comunicar, como 3.5 (build 3198), onde:

  • As versões major e minor são atualizadas manualmente.
  • O número do build aumenta automaticamente.
  • O incremento acontece apenas durante o processo de build de RELEASE.

A Solução

Passo 1: Localize Seu Arquivo de Projeto

A numeração da versão que você deseja alterar geralmente é configurada em um arquivo de projeto, comumente chamado AssemblyInfo.cs. Neste arquivo, você deve procurar pelo atributo de versão do assembly, que pode parecer algo como isto:

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

O caractere * instrui o Visual Studio a atribuir automaticamente os números do build e da revisão.

Passo 2: Defina o Número da Versão

Para personalizar seu formato de versionamento, substitua a numeração automática por uma string codificada que corresponda ao seu formato desejado:

[assembly: AssemblyVersion("3.5.3198.0")]

Aqui está uma explicação do formato da versão:

  • Versão major: 3
  • Versão minor: 5
  • Número do build: 3198 (Esse será gerado automaticamente)
  • Revisão: Você pode definir isso como 0 ou qualquer outro número de acordo com sua preferência.

Passo 3: Personalize para Builds de Debug vs. Release

Para garantir que o número do build aumenta apenas durante um build de release, você pode usar diretivas de pré-processador do compilador. É aqui que as coisas ficam um pouco mais avançadas, mas é uma ferramenta poderosa.

No AssemblyInfo.cs, você pode escrever um código condicional como este:

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

Essa configuração garante:

  • Durante um build DEBUG, a versão permanece estática.
  • Durante um build RELEASE, o número da versão será atualizado com base no sistema de build.

Conclusão

Alterar o formato de numeração de build no Visual Studio é um processo direto que pode melhorar significativamente a experiência do usuário. Ao seguir estas etapas, você pode criar uma estrutura de versionamento que não apenas é mais simples para os usuários comunicarem, mas também melhor alinhada com seu processo de desenvolvimento.

Ao personalizar sua estratégia de versionamento, você capacita seus usuários a reportarem problemas de forma eficaz, aumentando assim a comunicação entre desenvolvedores e usuários.

Boa programação!