C-Sharp Visual Studio Versioning

Atualize Seu Número de Versão no Visual Studio Automaticamente com Facilidade

Gerenciar números de versão em aplicações de software é crucial para acompanhar funcionalidades, correções e atualizações. Ao desenvolver aplicações no Visual Studio, você pode se ver precisando incrementar automaticamente o número da versão para cada compilação. Neste post de blog, vamos explorar como alcançar isso de forma eficaz para sua aplicação, especialmente se você estiver utilizando versões como Visual Studio 2005/2008.

Compreendendo o Formato do Número de Versão

Primeiro, vamos esclarecer o que queremos dizer com o formato do número de versão. Um número de versão típico segue a estrutura Principal.Menor.Build.Revisão. Por exemplo, no número da versão 1.1.38, os segmentos podem ser interpretados da seguinte forma:

  • Principal: Mudanças significativas que podem não ser compatíveis com versões anteriores.
  • Menor: Melhorias que são compatíveis com versões anteriores.
  • Build: Incrementado para cada nova compilação.
  • Revisão: Indica correções de bugs.

No .NET especificamente, é importante observar que o número Build é, na verdade, o terceiro dígito, ao contrário das expectativas de alguns desenvolvedores.

O Desafio: Configurando o Incremento Automático

Você pode encontrar um problema ao usar 1.0.* ou 1.0.0.* para números de build, já que essas configurações normalmente substituem os números de revisão e build por um timestamp, o que não é ideal para rastreamento. Você também pode enfrentar problemas quando sua aplicação possui um arquivo de configurações. Quando a versão do assembly muda, suas configurações podem ser redefinidas para o padrão porque sua aplicação pode procurar o arquivo de configurações em um diretório diferente.

A Solução: Tarefa AssemblyInfo

Para atualizar automaticamente o seu número de versão, você pode usar a Tarefa AssemblyInfo. Esta tarefa pode ser configurada especificamente para incrementar o número de build para você. Aqui está como configurá-la:

  1. Instale a Tarefa AssemblyInfo: Você pode encontrar a Tarefa AssemblyInfo aqui. Esta tarefa faz parte dos scripts MSBuild.

  2. Configure a Tarefa: Isso requer um pouco de configuração, mas automatizará o processo de versionamento. Consulte a documentação da tarefa para orientações sobre as opções de configuração.

Considerações Importantes

Antes de você implementar isso, tenha em mente duas limitações importantes:

  1. Limites de Números de Versão: Cada um dos quatro números na string de versão tem um limite máximo de 65535. Esse limite surge da arquitetura do Windows e não pode ser alterado. Para mais informações, você pode consultar este post de blog do MSDN.

  2. Integração com Subversion: Se você estiver usando Subversion, pode ser necessário fazer ajustes específicos para integrá-lo com a Tarefa AssemblyInfo. Você pode aprender mais sobre isso aqui.

Como Recuperar o Número da Versão

Uma vez que sua Tarefa AssemblyInfo esteja corretamente configurada e funcionando, recuperar o número da versão se torna simples. Abaixo está um trecho de código que mostra como acessar e formatar o número da versão:

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

Este trecho de código ajudará você a exibir o número da versão programaticamente dentro de sua aplicação, facilitando para os usuários relatarem problemas ou solicitar atualizações.

Conclusão: Simplifique Seu Gerenciamento de Versão

Gerenciar números de versão é um aspecto essencial do desenvolvimento de software. Ao implementar a Tarefa AssemblyInfo no Visual Studio, você pode automatizar o processo de incremento de versão, garantindo que usuários e desenvolvedores tenham um rastreamento de versão consistente. Essa abordagem não apenas economiza tempo, mas também melhora a comunicação entre usuários e desenvolvedores sobre atualizações e correções de software.

Agora que você tem uma compreensão clara de como configurar isso, pode prosseguir com confiança e aprimorar sua estratégia de controle de versão!

Sinta-se à vontade para compartilhar sua experiência ou quaisquer desafios que encontrou ao configurar isso nos comentários abaixo!