ToB企服应用市场:ToB评测及商务社交产业平台

标题: 单元测试必备：Asp.Net Core代码覆盖率实战，打造可靠应用 ! [打印本页]

---

作者: 曂沅仴駦    时间: 2024-5-18 02:13
标题: 单元测试必备：Asp.Net Core代码覆盖率实战，打造可靠应用 !
引言

在前几章我们深度解说了单元测试和集成测试的底子知识，这一章我们来解说一下代码覆盖率,代码覆盖率是单元测试运行的度量值,覆盖率通常以百分比表示，用于衡量代码被测试覆盖的程度，帮助开发职员评估测试用例的质量和代码的健壮性。常见的覆盖率包罗语句覆盖率（Line Coverage）、分支覆盖率（Branch Coverage）、路径覆盖率（Path Coverage）等，不同范例的覆盖率可以帮助开发职员更全面地了解测试用例对代码的覆盖环境，从而改进测试战略和进步代码质量。
核心组件

本文介绍如何通过 Coverlet 在单元测试中使用代码覆盖率和使用 ReportGenerator 生成报表。
什么是Coverlet？

Coverlet 是 GitHub 上的开源项目，可为 C# 提供跨平台代码覆盖率框架,Coverlet 是 .NET Foundation 的一部门,Coverlet 收集 Cobertura 覆盖率测试运行数据，用于生成报表。

什么是ReportGenerator?

ReportGenerator 将由 Cobertura 生成的覆盖率报表转换为各种格式的用户可读的报表。

代码覆盖率实战

我们在之前的项目中创建了Sample.Api和Sample.Repository用作我们单元测试和集成测试的Demo项目，接下来我们用这个项目来做一下单元测试覆盖。

• 创建xUnit测试项目
  然后看一下csproj的XML文件
  

1.   <ItemGroup>
2.     <PackageReference Include="coverlet.collector" Version="6.0.0" />
3.     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
4.     <PackageReference Include="xunit" Version="2.5.3" />
5.     <PackageReference Include="xunit.runner.visualstudio" Version="2.5.3" />
6.   </ItemGroup>

复制代码

从上面可以看出xUnit的测试项目已经默认对coverlet.collector添加了支持
我们在解说在单元测试中使用依赖注入时，用Sample.Repository做的单元测试，我们把之前的代码Copy一份,到新的测试项目，添加和解说依赖注入时一样的配置。
然后添加对我们Sample.Repository的项目引用

1. NuGet\Install-Package Xunit.DependencyInjection -Version 9.1.0
2. NuGet\Install-Package Xunit.DependencyInjection.Logging -Version 9.0.0

复制代码

可以看到我们项目根本成型了，但是Copy过来的代码照旧我们dotNetParadise.DependencyInjection测试依赖注入时那个类库。
一个小tips：

鼠标点击我们的测试项目dotNetParadise.CodeCoverage->右键->同步定名空间

可以看到我们的定名空间已经被正确替换
同步定名空间功能

• 使用机遇： 你想要通过将文件拖动到新文件夹重构部门解决方案。
  
• 操作原因： 你想要确保你的定名空间中的新文件夹布局保持最新。
  

开始统计

我们可以通过CMD命令进入测试项目类库的内

然后执行下面这个命令

1. dotnet test --collect:"XPlat Code Coverage"

复制代码

"XPlat Code Coverage" 参数是与 Coverlet 中的数据收集器对应的易记名称。 此名称是必需的，但不区分大小写。 若要使用 .NET 的内置代码覆盖率数据收集器，请使用"Code Coverage"。

看一下执行完控制台输出

通过控制台反馈我们得知了，生成了一个附件路径在
~\TestResults\2515646c-5845-4bfb-ae14-7e0bf4617b84\coverage.cobertura.xml

作为 dotnet test 运行的一部门，生成的 coverage.cobertura.xml 文件输出到 TestResults 目录 。 该 XML 文件包罗效果。 这是一个依赖于 .NET CLI 的跨平台选项，非常实用于不可使用 MSBuild 的生成系统。

简单解读一下
cobertura.xml代码覆盖率报告，提供了关于代码单元测试覆盖率的具体信息。其中包罗了各种指标和数据，如以下几点：

• line-rate 和 branch-rate 分别表示语句覆盖率和分支覆盖率，均为 0.5，表示被测试覆盖的比例为 50%。
  
• lines-covered 和 lines-valid 分别表示被覆盖的代码行数和总代码行数。
  
• branches-covered 和 branches-valid 分别表示被覆盖的分支数和总分支数。
  
• 在具体的类和方法级别，提供了各自的覆盖率、复杂度等信息，以及每行代码的覆盖环境（hits 表示执行次数，branch 表示是否为分支语句，condition-coverage 表示条件覆盖率）。
  

生成报告

上面提到了coverlet.collector是用来收集单元测试的指标的真正的报告是用 ReportGenerator生成。
第一步要将 ReportGenerator NuGet 包安装为 .NET 全局工具

1. dotnet tool install -g dotnet-reportgenerator-globaltool

复制代码

有许多种生成报告的方法如 命令行，添加netconfig等各人可以自行选择
下面用命令行来演示一下
导航到coverage.cobertura.xmlxml 报告文件下

1. reportgenerator -reports:"coverage.cobertura.xml" -targetdir:"coveragereport" -reporttypes:html

复制代码

输出:

查看测试报告：
我的路径：
TestResults\b5595744-2bb9-42ab-8c2e-60d544b4b04f\coveragereport

最后

通过创建测试项目并使用 Coverlet 进行代码覆盖率统计，我们可以得到具体的覆盖率报告。生成的 coverage.cobertura.xml 文件提供了各种指标和数据，如语句覆盖率、分支覆盖率等，帮助开发团队评估代码的测试覆盖环境。
随后，通过 ReportGenerator 工具生成报表，我们可以将覆盖率数据转换为易读的报表形式，帮助团队更直观地了解测试覆盖环境，进一步优化测试战略和进步代码质量。
通过以上实践，我们能够更有效地利用代码覆盖率工具，提升单元测试的质量和效率，从而构建更健壮的软件系统。

<em>
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/)

Powered by Discuz! X3.4