TestNG报告太丑? 测试结果维度展现有限? 无法区分用例优先级? 不方便查看错误信息?
Allure测试报告框架帮助你轻松实现”高大上”报告展示。本文通过示例演示如何从0到1集成Allure测试框架。重点展示了如何将Allure集成到已有的自动化测试工程中、以及如何实现报表的优化展示。Allure非常强大,支持多种语言多种测试框架,无论是Java/Python还是Junit/TestNG,其他语言或者框架实现的流程和本文一致,具体配置参照各语言框架规范。
此外,本文提供了一个基于TestNG+Maven的单元测试实例,用以模拟实际的自动化测试工程,代码位置:https://github.com/HelloKitty666/sample-unit-testngallure 。
下图展示了同一自动化测试工程的TestNG报告和Allure报告,Allure报告不仅在外观上有着显而易见的优势,还提供了多维度的测试结果展示。
TestNG默认报告
Allure报告
Allure集成自动化测试流程
Allure的集成分为如下步骤:
1. 编写自动化测试工程实现“单元测试/API测试/UI测试”
2. 下载配置Allure服务
3. 在自动化测试工程中引入Allure支持
4. 在自动化测试工程中引入Allure注解
5. 指定配置文件,选择运行的测试套件
6. 运行Allure服务进行报告展示
本文提供了一个基于TestNG+Maven的单元测试实例模拟实际的自动化测试工程,代码实例请到Github上下载:https://github.com/HelloKitty666/sample-unit-testngallure 。
工程结构说明:
• Application:基于maven管理的待测应用,模拟业务系统
• HelloTest: 基于TestNG实现的单元测试,用以测试Application代码
• testng.xml:TestNG的配置文件,用于动态配置运行时测试套件
配置Allure服务
进入Allure官网http://allure.qatools.ru/ ,点击右上角DownLoad进入下载页面,下载zip文件。
解压Zip文件,拷贝到指定目录下,配置系统环境变量指向解压后的bin目录:
进入命令行,运行allure –version,出现版本号提示说明allure服务已经安装配置完毕。
工程中引入Allure支持
本文是基于Maven实现工程管理,通过在pom.xml中配置Allure的jar包和插件实现TestNG默认报告的解析和优化,详细配置说明参见下图:
工程中引入Allure注解
Allure提供了强大的注解支持,通过这些注解可以实现报告的定制化展示,注解文档参见https://docs.qameta.io/allure/ :
• @Epic, @Feature, @Story提供的归类功能,类似于目录功能
• @DisplayName 指定Allure报告上展示的名字
• @Severity 说明测试用例重要性, 根据实际业务情况对用例进行分类
• @Step 说明测试执行步骤, 用于标识测试用例的执行细节
• @Attachment 添加HTML报告上展示的附件
• @Category 实现自定义的缺陷分类
• @TmsLink 实现和缺陷管理系统的关联
本示例中引入了@Epic, @Story, @Severity, @Step说明如何在已有的测试工程中添加Allure注解。
运行测试工程生成测试结果数据
本示例是基于Maven工程构建,在Eclipse中选中工程右键 Run as –> Maven test 运行测试,生成测试数据。
运行完毕以后会默认生成allure-results文件夹,并在其中保存测试数据(json格式的测试数据)
运行Allure服务生成美化后的测试报告
切换到工程根目录下,打开命令行运行allure serve 命令,生成测试报告。在浏览器中输入http://10.255.6.35:57135/index.html 即可查看测试报告。
测试报告解析
总览/图表页面 中查看测试概况:包含测试用例数,测试通过率,测试Defect,不同优先级测试用例的情况,测试执行耗时,测试套件数,测试的场景分类。其中测试场景由自动化代码中@Epic的标识,优先级由@Severity标识。
图表显示汇总数据
类别显示defect情况
功能显示用例分类
Allure不仅可以和TestNG/Junit集成,还可以集成到Jenkins当中发布测试报告。预知后事如何,请听下回分解。