英文原文: Easing into .NET Core with the Windows Compatibility Pack
从 .NET 迁移到 .NET Core 的一个主要原因,在于后者具备在 Linux 上运行的能力。但是对于大型企业应用,不可能实现一步迁移到位。由此,Microsoft 推荐采用一种逐步迁移做法:
这一做法理论上可行,但是在第二步中会有阻碍,因为缺乏关键 API。用于 .NET Core 的 Windows 兼容包的推出,意在解决这一问题。该兼容包是一个 NuGet 软件包集合,其中包含了近两万个 API,目的在于解决 Web 应用程序开发人员对于优秀软件库的需求。
新引入的 API 大体上可分为两类。一类是仅适用于 Windows 的 API,另一类是跨平台的软件库。其中,仅适用于 Windows 的 API 包括:
其中大部分 API 是与 Windows 操作系统紧密关联的,而相应的 Linux API 通常在设计上迥异。
跨平台的软件库包括:
需指出的是,这些 API 是刻意独立于 .NET Core 的完整发布的。对此,Microsoft 的 Immo Landwerth 给出了如下解释:
以独立软件包提供的原因在于:(一)不少 API 是仅出于兼容性的考虑而提供的。在新代码中,不应依赖于这些 API;(二)不少 API 仅用于 Windows 平台。我们不希望将用户引上一条更难以跨平台迁移应用的道路。
为了易于区分仅适用于 Windows 的和跨平台的 API,现在有一种 API 兼容性分析工具可用。该工具可以标记出那些在应用中不应继续依赖的 API。
你可以使用与弃用 API 相同的抑制选项,但是也可以选择对特定平台给出抑制警告。如果你仅规划在一组特定的平台上支持你的代码,例如只支持 Windows 和 Linux 但不支持 macOS,这一工具十分有用。为此,你只需编辑项目文件,添加一个
PlatformCompatIgnore
属性,并在该属性中列出所有要忽略的平台。