Home/ Questions/Q 6859749
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-05-27T02:19:19+00:00

I have an assembly that provides an API and is used by some other

  • 0

I have an assembly that provides an API and is used by some other assemblies. I need to verify that a newer version of API dll is still compatible with the older assemblies that were using the older version of API.

I’ve found a couple of questions that ask the same, but there are no answers that resolve my problem:

Suggested tools can only compare two assemblies and say if there are possible breaking changes in API, but not if the newest API really breaks the older assembly that uses it.
I’d like to find a tool or write a test that will be able to check whether each of the older dlls can work with my new API dll.

As for the changes in API more likely that I will only extend it, but even though it still can break the code in older assemblies. Some of the examples of such changes can be found here:

For now the only solution I see is to compile the source code of the older assemblies with the newest API, but I would like to do it only with assemblies and add them as part of my unit tests. Is there any better way I can handle that?

edit:

I’m looking for a tool that will be able to automate the process of verifying the backward compatibility between .net assemblies. (command line or with some api too)

Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. Editorial Team

    What you want is to do a diff and generate a the list of breaking changes. Then you want to search if of your assemblies does use any of the broken APIs. You can do this with ApiChange tool to do the diff and to find any affected users of it.

    To make it more concrete. If you have removed a method from an interface then you need to find all implementers and users of this method in classes which uses the interface method or any class that does implement this method.

    ApiChange can search for implementers and users of specific methods on the command line with the commands -whoimplementsinterface and -whousesmethod. It is not automated at the command line but you can directly use the ApiChange.Api.dll to automate this queries.

    Edit1:

    I just forgot: The ApiChange tool has actually the functionality you are interested in already. It is the option

    -ShowrebuildTargets -new -old [-old2 ] -searchin

    We did use it in our department with good results. The only gotcha are the XML Intellisense files. If another target does not use the removed method but references it inside the XmlDoc the compiler will write a warning that a non existing method was referenced. This is quite hard to catch and would involve to parse the intellisense docu files as well. But this is quite an edge case.

    • 0