.Net Attributes Versions

Compreendendo File Version e Assembly Version em Aplicações .NET

Ao trabalhar em aplicações .NET, gerenciar versionamento pode se tornar uma tarefa desafiadora. Em particular, os desenvolvedores frequentemente lutam com o uso adequado de File Version e Assembly Version. Neste post do blog, vamos explorar esses dois atributos de versionamento, sua importância e orientações sobre como usá-los efetivamente em seus projetos.

O Desafio do Versionamento

Projetos .NET normalmente requerem dois números de versão distintos: o File Version e o Assembly Version. Esses dois podem ser confusos, especialmente quando se trata de suas aplicações e como interagem entre si. Aqui está uma breve visão geral:

  • Assembly Version: Este atributo indica a versão do manifesto do assembly em si, que é crucial durante a resolução do assembly. É mais sobre a compatibilidade do seu código quando chamado por outros assemblies.

  • File Version: Isso se refere à versão do arquivo físico no disco, e não é utilizada pelo runtime do .NET. Isso significa que os usuários podem ver esta versão nas propriedades do arquivo do assembly, mas não afeta a referência de assemblies durante o tempo de execução.

Melhores Práticas para Usar File Version e Assembly Version

Mantê-los Separados

Uma prática comum é manter a versão do assembly constante enquanto atualiza a versão do arquivo. Por exemplo, se você tiver vários assemblies, como um executável (exe) e várias bibliotecas de link dinâmico (dlls), você pode:

  • Definir a mesma Assembly Version para todos os assemblies (exe e dlls). Dessa forma, você mantém sua interface de assembly consistente.
  • Diferenciar o File Version para assemblies individuais (ex: exe tem versão 1.0.0.0 enquanto dll1 tem 1.0.0.1, dll2 tem 1.0.0.2, etc.). Isso permite que você rastreie mudanças feitas especificamente nos executáveis.

Essa estratégia permite que você mantenha uma compreensão clara de qual versão de cada DLL alinha-se com o executável, simplificando o gerenciamento de projetos e minimizando problemas de compatibilidade.

Incremento Automático de Versões

Em alguns casos, os desenvolvedores preferem incrementar automaticamente o File Version para cada compilação, atualizando manualmente a Assembly Version apenas quando mudanças significativas são feitas. Isso significa que, após cada compilação, a File Version pode refletir detalhes específicos da compilação (por exemplo, 1.0.0.1, 1.0.0.2, e assim por diante), enquanto as atualizações da Assembly Version ocorrem em um intervalo maior (como 1.0.0 para 1.0.1, etc.).

O Papel do AssemblyInformationalVersion

O atributo AssemblyInformationalVersion é mais uma ferramenta importante de versionamento. Este atributo pode armazenar uma representação em string da versão, normalmente usada para fins informativos para exibir detalhes adicionais sobre a versão atual que podem não se encaixar perfeitamente nos sistemas estruturados de versionamento.

  • Isso pode incluir rótulos como “beta”, “release candidate” ou outros marcadores qualitativos.
  • Ajuda os usuários a entenderem o estado do software de relance.

Conclusão

Compreender e utilizar efetivamente File Version, Assembly Version e AssemblyInformationalVersion em seus projetos .NET pode levar a um melhor controle de versão e a um processo de desenvolvimento mais tranquilo. Ao adotar convenções de versionamento consistentes, você pode minimizar conflitos potenciais e manter seus projetos gerenciáveis.

Para orientação adicional, você pode consultar o artigo de suporte da Microsoft: Como usar a versão de Assembly e a versão de arquivo de Assembly.

Ao seguir essas práticas, você não apenas manterá seu código organizado, mas também melhorará a colaboração em ambientes de equipe onde vários desenvolvedores estão trabalhando na mesma aplicação.