使用Windows兼容包简化向.NET Core的迁移

向右看齐 2022-06-02 01:52 201阅读 0赞

从.NET迁移到.NET Core的一个主要原因，在于后者具备在Linux上运行的能力。但是对于大型企业应用，不可能实现一步迁移到位。由此，[Microsoft][]推荐采用一种逐步迁移做法：

*  第一步，迁移到ASP.NET Core（依然使用.NET Framework）；
 *  第二步，迁移到.NET Core（依然运行在Windows上）；
 *  第三步，迁移到Linux上；
 *  第四步，迁移到（托管Linux主机的）Azure中。

这一做法理论上可行，但是在第二步中会有阻碍，因为缺乏关键API。[用于.NET Core的Windows兼容包][.NET Core_Windows]的推出，意在解决这一问题。该兼容包是一个NuGet软件包集合，其中包含了近两万个API，目的在于解决Web应用程序开发人员对于优秀软件库的需求。

新引入的API大体上可分为两类。一类是仅适用于Windows的API，另一类是跨平台的软件库。其中，仅适用于Windows的API包括：

*  Active directory；
 *  加密；
 *  事件日志和性能计数器；
 *  文件系统安全；
 *  命名管道；
 *  注册表访问（Registry Access）；
 *  Windows服务。

其中大部分API是与Windows操作系统紧密关联的，而相应的Linux API通常在设计上迥异。

跨平台的软件库包括：

*  缓存；
 *  配置管理（ConfigurationManager），即处理遗留的app.config和web.config文件；
 *  数据集扩展（DatasetExtensions），用于不使用ORM访问数据库；
 *  ODBC数据库访问；
 *  System.Configuration.ConfigurationManager（MEF v1）；
 *  System.Drawing；
 *  System.IO.Packaging，用于与MS Office类型的压缩文件交互；
 *  System.ServiceModel，即WCF（Windows Communication Foundation）。

需指出的是，这些API是刻意独立于.NET Core的完整发布的。对此，Microsoft的Immo Landwerth给出了如下解释：

> 以独立软件包提供的原因在于：（一）不少API是仅出于兼容性的考虑而提供的。在新代码中，不应依赖于这些API；（二）不少API仅用于Windows平台。我们不希望将用户引上一条更难以跨平台迁移应用的道路。

为了易于区分仅适用于Windows的和跨平台的API，现在有一种[API兼容性分析工具][API]可用。该工具可以标记出那些在应用中不应继续依赖的API。

> 你可以使用与弃用API相同的抑制选项，但是也可以选择对特定平台给出抑制警告。如果你仅规划在一组特定的平台上支持你的代码，例如只支持Windows和Linux但不支持macOS，这一工具十分有用。为此，你只需编辑项目文件，添加一个`PlatformCompatIgnore`属性，并在该属性中列出所有要忽略的平台。

[Microsoft]: https://www.evget.com/supplier/186
[.NET Core_Windows]: https://blogs.msdn.microsoft.com/dotnet/2017/11/16/announcing-the-windows-compatibility-pack-for-net-core/
[API]: https://blogs.msdn.microsoft.com/dotnet/2017/10/31/introducing-api-analyzer/