¿Cómo puedo probar la compatibilidad con versiones anteriores de la API entre los ensamblados de .NET

Question

Tengo un ensamblado que proporciona una API y que otros ensamblajes utilizan. Necesito verificar que una versión más nueva de API dll todavía sea compatible con los ensamblajes anteriores que usaban la versión anterior de API.

he encontrado un par de preguntas que hacen la misma, pero no hay respuestas que resuelven mi problema:

• Tool to verify compatibility of a public APIs
• Tool for backwards compatibility for the C#/.NET API

herramientas sugeridas sólo se puede comparar dos ensamblados y decir si hay posibles cambios en la API, pero no si la API más nueva realmente rompe el ensamblaje anterior que la usa. Me gustaría encontrar una herramienta o escribir una prueba que pueda verificar si cada uno de los dlls más antiguos puede funcionar con mi nueva API dll.

En cuanto a los cambios en la API es más probable que solo lo extienda, pero a pesar de que todavía puede romper el código en ensamblajes anteriores. Algunos de los ejemplos de este tipo de cambios se puede encontrar aquí:

• A definite guide to API-breaking changes in .NET
• .NET: with respect to AssemblyVersion, what defines binary compatibility?

Por ahora la única solución que veo es para compilar el código fuente de los conjuntos de mayor edad con la nueva API , pero me gustaría hacerlo solo con ensamblajes y agregarlos como parte de mis pruebas unitarias. ¿Hay alguna forma mejor de que pueda manejar eso?

edición:

Estoy buscando una herramienta que será capaz de automatizar el proceso de verificación de la compatibilidad hacia atrás entre los ensamblados .NET. (línea de comandos o con alguna API también)

Answer 1

Lo que quiere es hacer una diferencia y generar una lista de cambios de última hora. Luego desea buscar si sus ensamblajes utilizan alguna de las API rotas. Puedes hacer esto con la herramienta ApiChange para hacer el diff y encontrar a los usuarios afectados.

Para hacerlo más concreto. Si eliminó un método de una interfaz, entonces necesita encontrar todos los implementadores y usuarios de este método en las clases que usan el método de interfaz o cualquier clase que implemente este método.

ApiChange puede buscar ejecutores y usuarios de métodos específicos en la línea de comandos con los comandos -whoimplementsinterface y -whousesmethod. No está automatizado en la línea de comandos, pero puede usar directamente el ApiChange.Api.dll para automatizar estas consultas.

Edit1:

me olvidó: La herramienta ApiChange tiene en realidad el functionality le interesa ya. Es la opción

-ShowrebuildTargets -nuevo -old [-old2] -searchin

lo utilizamos en nuestro departamento con buenos resultados. Lo único que tengo son los archivos XML Intellisense.Si otro objetivo no utiliza el método eliminado pero lo hace referencia dentro del XmlDoc, el compilador escribirá una advertencia de que se hizo referencia a un método no existente. Esto es bastante difícil de detectar y también implica analizar los archivos de documentos intellisense. Pero esto es todo un caso marginal.