.NET 类库可移植性分析器教程

小渣渣

想要让你的库在多个平台上使用？ 想要了解让应用与其他 .NET 实现和配置文件（包括 .NET Core、.NET Standard、UWP 以及适用于 iOS、Android 和 Mac 的 Xamarin）兼容所需的工作量？ .NET 可移植性分析器工具可通过分析程序集，详细报告程序在各种 .NET 实现上的灵活性。 可移植性分析器以 Visual Studio 扩展和控制台应用的形式提供。
了解如何将 .NET Framework 库代码移植到 .NET Core，以跨平台运行并扩展使用该代码的应用的范围。


新目标

• .NET Core：采用模块化设计，可并行工作，面向跨平台方案。 可并行工作意味着无需破坏其他应用即可采用新的 .NET Core 版本。
• ASP.NET Core：构建在 .NET Core 基础之上的新型 Web 框架，为开发人员提供与 .NET Core 相同的优势。
• 通用 Windows 平台：使用 .NET Native 的静态编译，提高 x64 和 ARM 计算机上运行的 Windows 应用商店应用的性能。
• .NET Core + 平台扩展：除 WCF、ASP.NET Core、FSharp 和 Azure 等 .NET 生态系统中的其他 API 外还包括 .NET Core API。
• .NET Standard + 平台扩展：除 WCF、ASP.NET Core、FSharp 和 Azure 等 .NET 生态系统中的其他 API 外还包括 .NET Standard API。
  

如何使用可移植性分析器

若要开始使用 .NET 可移植性分析器，首先需要从 Visual Studio Marketplace 下载相应的扩展。 它适用于 Visual Studio 2017 及更高版本。 可以在 Visual Studio 中转到“分析” > “可移植性分析器设置”并选择目标平台，对可移植性分析器进行配置。


下载地址：超链接登录可见。

GitHub地址：超链接登录可见。





若要分析整个项目，请在“解决方案资源管理器”中右键单击该项目，然后选择“分析程序集可移植性”。 也可以转到“分析”菜单，选择“分析程序集可移植性”。 在该位置选择项目的可执行文件或 DLL。



运行分析后，将看到 .NET 可移植性报告。 只有不受目标平台支持的类型才显示在列表中，可在“错误列表”的“消息”选项卡中查看建议。 还可以直接从“消息”选项卡跳转到问题区域。





如果不想使用 Visual Studio，可以通过命令提示符使用可移植性分析器。 只需从 Microsoft/dotnet-apiport 存储库下载 API 可移植性分析器即可。地址：超链接登录可见。

• 键入以下命令即可分析当前目录：\...\ApiPort.exe analyze -f .
• 若要分析特定的 .dll 文件列表，请键入以下命令：\...\ApiPort.exe analyze -f first.dll -f second.dll -f third.dll
  

.NET 可移植性报告以 Excel 文件 (.xlsx) 格式保存在当前目录中。 Excel 工作簿中的“详细信息”选项卡包含详细信息。