背景

很多情况下，我们编写了一些工具库之后，往往在某些框架版本中会出现一些问题，比如本人最近写的一个导入导出的工具库Magicodes.IE就出现了以下问题：

（GitHub：https://github.com/xin-lai/Magicodes.IE）

虽然支持标准库2.0，但是通过编写单元测试，确实发现如此：

因此，单元测试确实需要针对各个框架版本进行测试，并且相关代码需要针对框架进行兼容修改。那么如何实现呢？接下来我们一步步实践。

.NET框架版本说明

最新目标框架版本

下表定义了最常见的目标框架、如何引用这些框架，以及它们实现的 .NET Standard 版本。 这些目标框架版本是最新的稳定版本。 预览版不会显示。 目标框架名字对象 (TFM) 是一个标准化令牌格式，用于指定 .NET 应用或库的目标框架。

支持的目标框架版本

目标框架通常由 TFM 引用。 下表显示 .NET Core SDK 和 NuGet 客户端支持的目标框架。 等效项显示在括号内。 例如，win81 对于 netcore451 来说等效于 TFM。

如何让工程支持多个框架？

以单元测试工程为例：

<PropertyGroup><TargetFrameworks>netcoreapp3.0;netcoreapp2.2;netcoreapp3.1;net461</TargetFrameworks><IsPackable>false</IsPackable></PropertyGroup>

如上述代码所示，我们可以通过“TargetFrameworks”元素来定义多个框架。那么如何在工程里面添加条件判断以进行编译呢？

<ItemGroup Condition=" '$(TargetFramework)' == 'net461' "><PackageReference Include="Newtonsoft.Json" Version="12.0.3" /></ItemGroup>

除了工程里面，我们代码中如何针对不同的框架版本编写代码呢？

#if NET461return excelPackage.Workbook.Worksheets[typeof(T).GetDisplayName()] ??excelPackage.Workbook.Worksheets[ExcelImporterSettings.SheetName] ??excelPackage.Workbook.Worksheets[1];
#elsereturn excelPackage.Workbook.Worksheets[typeof(T).GetDisplayName()] ??excelPackage.Workbook.Worksheets[ExcelImporterSettings.SheetName] ??excelPackage.Workbook.Worksheets[0];
#endif

这些“NET461”的符号都有哪些呢？如下所示：

完整的 .NET Core 目标框架的预处理器符号列表

Magicodes.IE之多框架版本测试

了解了这些知识，我们就可以编写多框架版本的实现和单元测试了。

单元测试添加多框架支持

1. 修改TargetFramework为TargetFrameworks

   

2. 设置分组

   根据目标框架分组：

   

3. 修复编译错误

4. 执行单元测试

   单元测试结果如下图所示：

   

   针对具体的单元测试，我们还可以指定目标框架进行运行和调试：

总结和经验分享

结合整改的过程，我们可以得出以下经验：

• 单元测试编写时的异常消息判断尽量使用字符串包含判断，而不判断完整格式。

如上面所示，左侧代码在net461、netcoreapp2.2都是无法通过的，格式化的参数模板不一致。

• 特定框架、平台代码需添加符号判断

如下面示例，默认情况下，.NET Core 不提供除代码页 28591 以外的其他任何代码页编码和 Unicode 编码，例如 UTF-8 和 UTF-16，所以我们可以使用以下代码进行添加，但是需要排除.NET Framework：

除了特定代码之外，有时还有特定依赖的包：

• 在某些情况下不要使用过新的语法

比如以下代码：

转载是一种动力 分享是一种美德

如果喜欢作者的文章，请关注【麦扣聊技术】订阅号以便第一时间获得最新内容。本文版权归作者和湖南心莱信息科技有限公司共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。

文档官网：docs.xin-lai.com

QQ群：

编程交流群<85318032>

产品交流群<897857351>