代码覆盖率报告 - Amazon CodeBuild
创建代码覆盖率报告
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

代码覆盖率报告

CodeBuild 允许您为测试生成代码覆盖率报告。提供以下代码覆盖率报告：

行覆盖率

行覆盖率衡量您的测试涵盖了多少语句。语句是一条指令，不包括注释或条件。

line coverage = (total lines covered)/(total number of lines)

分支覆盖率

分支覆盖率衡量您的测试覆盖了控制结构（例如 if 或 case 语句）中所有可能的分支中的多少个分支。

branch coverage = (total branches covered)/(total number of branches)

支持以下代码覆盖率报告文件格式：

  • JaCoCo XML

  • SimpleCov JSON¹

  • Clover XML

  • Cobertura XML

¹ CodeBuild 接受 simplecov（而非 simplecov-json）生成的 JSON 代码覆盖率报告。

创建代码覆盖率报告

要创建代码覆盖率报告，您运行的构建项目应在构建规范文件中配置有至少一个代码覆盖率报告组。CodeBuild 将解读代码覆盖率结果并为运行提供代码覆盖率报告。对于使用相同构建规范文件的每个后续构建，系统将生成一个新的测试报告。

创建测试报告

  1. 创建构建项目。有关信息，请参阅在 Amazon CodeBuild 中创建构建项目。

  2. 使用测试报告信息配置项目的构建规范文件：

    1. 添加 reports: 部分并指定报告组的名称。CodeBuild 将使用项目名称和您指定的格式为 project-name-report-group-name-in-buildspec 的名称为您创建一个报告组。如果已存在要使用的报告组，请指定其 ARN。如果您使用其名称，而不是 ARN，CodeBuild 会创建一个新的报告组。有关更多信息，请参阅Reports syntax in the buildspec file。

    2. 在报告组下，指定包含代码覆盖率结果的文件的位置。如果您使用多个报告组，请为每个报告组指定结果文件位置。每次运行构建项目时都会创建一个新的代码覆盖率报告。有关更多信息，请参阅指定测试文件。

      以下示例为 test-results/jacoco-coverage-report.xml 中的 JaCoCo XML 结果文件生成代码覆盖率报告。

      reports:
  jacoco-report:
    files:
      - 'test-results/jacoco-coverage-report.xml'
    file-format: 'JACOCOXML'

    3. 在 build 或 post_build 序列的 commands 部分中，指定用来运行代码覆盖率分析的命令。有关更多信息，请参阅 指定测试命令 。

  3. 运行构建项目中的构建。有关更多信息，请参阅在 Amazon CodeBuild 中运行构建。

  4. 构建完成后，从项目页面上的构建历史记录中选择新的构建运行。选择报告来查看代码覆盖率报告。有关更多信息，请参阅查看构建的测试报告。