Introducción

Al trabajar en un proyecto .NET que referencia un COM DLL, es crucial asegurarse de que tu proyecto mantenga la versión correcta de la DLL interopera. Esto es esencial no solo para rastrear la compatibilidad, sino también para garantizar que tu aplicación funcione sin problemas a través de actualizaciones y parches. En esta publicación del blog, exploraremos cómo gestionar adecuadamente las versiones de tus referencias COM DLL en un entorno .NET y abordaremos las trampas comunes.

El Problema en Cuestión

El problema surge cuando utilizas Visual Studio para agregar una referencia COM. Por defecto, la versión asignada puede no alinearse con la versión de la DLL COM original. Esta discrepancia puede conducir a dificultades, especialmente cuando están involucrados parches. Puedes encontrarte preguntando:

• ¿Cómo puedo asegurarme de que la DLL interopera creada tenga la versión correcta?
• ¿Hay alguna forma de incorporar un número de compilación junto con las versiones mayor y menor?

¡Vamos a sumergirnos en la solución!

Entendiendo las Versiones de Referencia COM

Antes de abordar la solución, es importante entender de dónde proviene la versión:

1. Bibliotecas de Tipos (TypeLibs): En COM, la versionado está principalmente asociado a la Biblioteca de Tipos en lugar de la DLL en sí. El GUID se refiere a la TypeLib, y los números de versión corresponden a los atributos VersionMajor y VersionMinor de esa TypeLib.

2. Almacenamiento en el Registro: Los números de versión se almacenan en el registro de Windows bajo:

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

   Aquí, la versión mayor debe ser algo, mientras que la versión menor puede establecerse en cero, lo que significa que importará la última versión coincidente.

Pasos para Gestionar el Versionado de tu COM DLL

1. Referencia la Biblioteca de Tipos en lugar de la DLL

En lugar de referenciar directamente el COM DLL, referencia la Biblioteca de Tipos. De esta manera, heredas el versionado asociado a ella. Asegúrate de que al usar TlbImp, incluyas la bandera /asmversion para especificar la versión deseada.

2. Usando Visual Studio para Establecer la Versión

Para establecer manualmente la versión mientras usas Visual Studio, editar el archivo .vcproj puede ayudar. Aquí tienes un ejemplo para guiarte:

<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 la Configuración del Registro

Después de realizar cambios, verifica que los nuevos números de versión aparezcan correctamente en el registro. Este paso de confirmación te proporcionará tranquilidad de que tu aplicación seguirá funcionando correctamente a través de actualizaciones.

4. Limitaciones del Soporte de Versionado

Desafortunadamente, el sistema de versiones solo admite números de versión mayor y menor y no acomoda una versión de compilación. Esto está determinado por el archivo IDL asociado a tu TypeLib. Si necesitas información de versión más granular, considera seguir una convención de nomenclatura en tu sistema de gestión de proyectos.

Conclusión

Asegurar que tu DLL interopera de un COM DLL referenciado en un proyecto .NET mantenga la versión correcta puede ser complejo, pero al seguir los pasos descritos anteriormente, puedes lograr un enfoque más manejable. Recuerda, la clave es enfocarse en la versión de la TypeLib en lugar de la versión de la DLL directamente y verificar la configuración del registro después de las modificaciones.

Al utilizar estos métodos, no solo evitarás la frustración de versiones desalineadas, sino que también optimizarás tus actualizaciones y mantendrás la integridad de tu aplicación a través de parches.

Si tienes más preguntas o ideas sobre la gestión de versiones de COM DLL en proyectos .NET, ¡no dudes en compartir tus experiencias!