自动化测试报告——Allure！

TestNG报告太丑? 测试结果维度展现有限? 无法区分用例优先级? 不方便查看错误信息?

Allure测试报告框架帮助你轻松实现”高大上”报告展示。本文通过示例演示如何从0到1集成Allure测试框架。重点展示了如何将Allure集成到已有的自动化测试工程中、以及如何实现报表的优化展示。Allure非常强大，支持多种语言多种测试框架，无论是Java/Python还是Junit/TestNG，其他语言或者框架实现的流程和本文一致，具体配置参照各语言框架规范。

此外，本文提供了一个基于TestNG+Maven的单元测试实例，用以模拟实际的自动化测试工程，代码位置：https://github.com/HelloKitty666/sample-unit-testngallure 。

image TestNG报告vs Allure报告 image

下图展示了同一自动化测试工程的TestNG报告和Allure报告，Allure报告不仅在外观上有着显而易见的优势，还提供了多维度的测试结果展示。

TestNG默认报告

image

Allure报告

image image

Allure集成自动化测试流程

image

Allure的集成分为如下步骤：

• 1. 编写自动化测试工程实现“单元测试/API测试/UI测试”

• 2. 下载配置Allure服务

• 3. 在自动化测试工程中引入Allure支持

• 4. 在自动化测试工程中引入Allure注解

• 5. 指定配置文件，选择运行的测试套件

• 6. 运行Allure服务进行报告展示

image 编写自动化测试工程 image

本文提供了一个基于TestNG+Maven的单元测试实例模拟实际的自动化测试工程，代码实例请到Github上下载：https://github.com/HelloKitty666/sample-unit-testngallure 。

工程结构说明：

image

• Application：基于maven管理的待测应用，模拟业务系统

• HelloTest: 基于TestNG实现的单元测试，用以测试Application代码

• testng.xml：TestNG的配置文件，用于动态配置运行时测试套件

配置Allure服务

进入Allure官网http://allure.qatools.ru/ ，点击右上角DownLoad进入下载页面，下载zip文件。

image

解压Zip文件，拷贝到指定目录下，配置系统环境变量指向解压后的bin目录：

image image

进入命令行，运行allure –version，出现版本号提示说明allure服务已经安装配置完毕。

image

工程中引入Allure支持

本文是基于Maven实现工程管理，通过在pom.xml中配置Allure的jar包和插件实现TestNG默认报告的解析和优化，详细配置说明参见下图：

image

工程中引入Allure注解

Allure提供了强大的注解支持，通过这些注解可以实现报告的定制化展示，注解文档参见https://docs.qameta.io/allure/ ：

• @Epic, @Feature, @Story提供的归类功能，类似于目录功能

• @DisplayName 指定Allure报告上展示的名字

• @Severity 说明测试用例重要性, 根据实际业务情况对用例进行分类

• @Step 说明测试执行步骤, 用于标识测试用例的执行细节

• @Attachment 添加HTML报告上展示的附件

• @Category 实现自定义的缺陷分类

• @TmsLink 实现和缺陷管理系统的关联

本示例中引入了@Epic, @Story, @Severity, @Step说明如何在已有的测试工程中添加Allure注解。

image

运行测试工程生成测试结果数据

本示例是基于Maven工程构建，在Eclipse中选中工程右键 Run as –> Maven test 运行测试，生成测试数据。

image

运行完毕以后会默认生成allure-results文件夹，并在其中保存测试数据(json格式的测试数据)

image

运行Allure服务生成美化后的测试报告

切换到工程根目录下，打开命令行运行allure serve 命令，生成测试报告。 image

在浏览器中输入http://10.255.6.35:57135/index.html 即可查看测试报告。

测试报告解析

总览/图表页面 中查看测试概况：包含测试用例数，测试通过率，测试Defect，不同优先级测试用例的情况，测试执行耗时，测试套件数，测试的场景分类。其中测试场景由自动化代码中@Epic的标识，优先级由@Severity标识。

图表显示汇总数据

image

类别显示defect情况

image

功能显示用例分类

image

Allure不仅可以和TestNG/Junit集成，还可以集成到Jenkins当中发布测试报告。预知后事如何，请听下回分解。