将代码从 .NET Framework 移植到 .NET CorePort your code from .NET Framework to .NET Core

这是我们建议在将项目移植到.NET Core 时采取的过程。该过程的每个步骤将在以后的文章中详细介绍。

• 标识并记录第三方依赖项。

此步骤包含了解什么是第三方依赖项，如何依赖于它们，如何查看它们是否也在 .NET Core 上运行，以及如果没有在其上运行可以采取的步骤。它还介绍了如何将依赖项迁移到 .NET Core 中使用的 PackageReference 格式。

此步骤可确保在 .NET Core 不支持特殊 API 的情况下，可以为特定于 .NET Framework 的目标使用备用 API。

• 使用 来分析程序集并基于结果制定移植计划。

• 将项目文件转换为目标 .NET Core 版本后，可以使用基于 Roslyn 的 .NET API 分析器来确定在一些平台上触发 的 API 以及一些其他潜在兼容性问题。

• 移植测试代码。

由于移植到 .NET Core 对代码库来说是很大的更改，因此强烈建议移植测试代码，以便在移植代码时可以进行测试。MSTest、xUnit 和 NUnit 都支持 .NET Core。

• .NET 可移植性分析器 - 命令行工具或 ，一款可就代码在 .NET Framework 与目标 .NET Core 平台之间的可移植性生成报表的工具。此报表按逐个程序集细分列出了目标 .NET Core 平台上缺少的类型和 API。有关详细信息，请参阅 .NET Portability Analyzer。建议开始移植之前先运行 .NET 可移植性分析器工具，因为它可帮助确定特定目标 .NET 平台公共图面上缺少的 API 中的任何空白。
• .NET API 分析器 - 一款 Roslyn 分析器，可用于发现在某些平台上引发 的 .NET Standard API、检测对已弃用的 API 的调用，并发现不同平台上针对 C# API 的潜在兼容性风险。有关详细信息，请参阅 .NET API 分析器。在已创建 .NET Core 项目来确定不同平台上的运行时行为差异之后，此分析器非常有用。
• Reverse Package Search - 一个，能够实现搜索某一类型并找到包含该类型的包。此外，可以尝试使用 CsprojToVs2017 工具将较小的解决方案或单个项目移植到 .NET Core 项目文件格式。

警告

CsprojToVs2017 是第三方工具。不能保证它适用于所有项目，而且它可能会导致所依赖的行为发生细微变化。CsprojToVs2017 应作为一个起点 ，以自动化可自动执行的基本操作。它不是迁移项目文件格式的有保证的解决方案。