Introdução

Ao trabalhar em um projeto .NET que referencia uma COM DLL, é crucial garantir que seu projeto mantenha a versão correta da DLL de interop. Isso é essencial não apenas para acompanhar a compatibilidade, mas também para garantir que sua aplicação funcione perfeitamente em meio a atualizações e patches. Neste post do blog, exploraremos como gerenciar corretamente as versões de suas referências COM em um ambiente .NET e abordaremos armadilhas comuns.

O Problema em Questão

O problema surge quando você usa o Visual Studio para adicionar uma referência COM. Por padrão, a versão atribuída pode não estar alinhada com a versão da DLL COM original. Essa discrepância pode levar a dificuldades, especialmente quando patches estão envolvidos. Você pode se perguntar:

• Como posso garantir que a DLL de interop criada tenha a versão correta?
• Há uma maneira de incorporar um número de build junto com as versões principal e secundária?

Vamos mergulhar na solução!

Entendendo as Versões de Referência COM

Antes de tratarmos da solução, é importante entender de onde vem a versão:

1. Bibliotecas de Tipos (TypeLibs): No COM, a versionação está principalmente associada à Biblioteca de Tipos, em vez da DLL em si. O GUID refere-se à TypeLib, e os números de versão correspondem aos atributos VersionMajor e VersionMinor dessa TypeLib.

2. Armazenamento no Registro: Os números de versão são armazenados no registro do Windows em:

   HKEY_CLASSES_ROOT\Typelib\{uuid typelib}\Major.Minor
   

   Aqui, a versão principal deve ser algum valor, enquanto a versão secundária pode ser definida como zero, significando que a última versão correspondente será importada.

Passos para Gerenciar a Versionação da Sua DLL COM

1. Referenciar a Biblioteca de Tipos em vez da DLL

Em vez de referenciar diretamente a DLL COM, referencie a Biblioteca de Tipos. Dessa forma, você herda a versionação associada a ela. Certifique-se de que ao usar TlbImp, você inclua a flag /asmversion para especificar a versão desejada.

2. Usando o Visual Studio para Definir a Versão

Para definir manualmente a versão ao usar o Visual Studio, editar o arquivo .vcproj pode ajudar. Aqui está um exemplo para guiá-lo:

<ItemGroup>
    <COMReference Include="MYDLLLib">
        <Guid>{459F8813-D74D-DEAD-BEEF-00CAFEBABEA5}</Guid>
        <VersionMajor>1</VersionMajor> 
        <VersionMinor>0</VersionMinor> 
        <Lcid>0</Lcid>
        <WrapperTool>tlbimp</WrapperTool>
        <Isolated>False</Isolated>
    </COMReference>
</ItemGroup>

3. Verificar as Configurações do Registro

Após fazer as alterações, verifique se os novos números de versão aparecem corretamente no registro. Esta etapa de confirmação fornecerá a tranquilidade de que sua aplicação continuará a funcionar corretamente em meio a atualizações.

4. Limitações do Suporte à Versionação

Infelizmente, o sistema de versão suporta apenas números de versão principal e secundária e não acomoda uma versão de build. Isso é determinado pelo arquivo IDL associado à sua TypeLib. Se você precisar de informações de versão mais granulares, considere seguir uma convenção de nomenclatura em seu sistema de gerenciamento de projetos.

Conclusão

Garantir que sua DLL de interop a partir de uma DLL COM referenciada em um projeto .NET mantenha a versão correta pode ser complexo, mas seguindo os passos descritos acima, você pode alcançar uma abordagem mais gerenciável. Lembre-se, a chave é focar na versão da TypeLib em vez da versão da DLL diretamente e verificar as configurações do registro após modificações.

Ao usar esses métodos, você não apenas evitará a frustração de versões incompatíveis, mas também agilizará suas atualizações e manterá a integridade da sua aplicação durante os patches.

Se você tiver mais perguntas ou insights sobre o gerenciamento de versões de DLL COM em projetos .NET, fique à vontade para compartilhar suas experiências!