c# - 向后兼容 C#/.NET API 的工具？

Question

我找到了这个工具http://sab39.netreach.com/Software/Japitools/JDK-Results/46/，它使用 javadoc 检查不同版本的 Java API 之间的向后兼容性。

是否有与 C#/.NET 等效的工具？

以下是使用此工具比较 JDK 1.5 和 JDK 6 API 的示例： http ://www.kaffe.org/~stuart/japi/htmlout/h-jdk15-jdk6

Answer 1

• ApiChange确实采用了一组“旧”程序集和一组“新”程序集，它们因可能破坏 Api 更改而有所不同：

  ApiChange -diff -old HelloWorldV1.dll -new HelloWorldV2.dll

• LibCheck允许您比较程序集的两个版本并确定差异。该工具将差异报告为“已删除”和“添加”API 的组合：

  LibCheck -store HelloWorld.dll 1.0 -full C:\HelloWorldV1\
  LibCheck -store HelloWorld.dll 2.0 -full C:\HelloWorldV2\
  LibCheck -compare 1.0 2.0

另请参阅“使用 LibCheck”、“突出显示程序集修订之间的公共 API 差异”和“程序集之间的 Api 差异”文章。

Answer 2

我没有尝试过您链接到的 Java 工具，但NDepend有一些强大的工具可以比较两组二进制文件并突出显示任何差异。

Answer 3

我还没有测试过，但是这个库 https://github.com/tunnelvisionlabs/dotnet-compatibility 似乎提供了你想要的。

https://raw.githubusercontent.com/tunnelvisionlabs/dotnet-compatibility/master/CompatibilityCheckExample/Program.cs

IPackageRepository sourceRepository = PackageRepositoryFactory.Default.CreateRepository("https://www.nuget.org/api/v2/");
PackageManager packageManager = new PackageManager(sourceRepository, temporaryDirectory);
packageManager.PackageInstalled += HandlePackageInstalled;
packageManager.InstallPackage("Microsoft.Bcl.Immutable", SemanticVersion.Parse("1.0.34"));
packageManager.InstallPackage("System.Collections.Immutable", SemanticVersion.Parse("1.1.33-beta"));

using (PEReader referenceAssembly = new PEReader(File.OpenRead(Path.Combine(temporaryDirectory, "Microsoft.Bcl.Immutable.1.0.34", "lib", "portable-net45+win8+wp8+wpa81", "System.Collections.Immutable.dll"))))
{
    using (PEReader newAssembly = new PEReader(File.OpenRead(Path.Combine(temporaryDirectory, "System.Collections.Immutable.1.1.33-beta", "lib", "portable-net45+win8+wp8+wpa81", "System.Collections.Immutable.dll"))))
    {
        Analyzer analyzer = new Analyzer(referenceAssembly, newAssembly, null);
        analyzer.Run();
    }
}