官方网站在这里:http://extentreports.relevantcodes.com/
当年github上开源,如今pro版本居然收钱了
先说总结:
1. 生成的报告简洁美观,
2.生成的单html方便jenkins集成发邮件
3.自带集中展示历史报告的服务端
4.支持java,
5.可定制报告
6.数据入库
官网提供V2.x版本和V3.x版本,只支持java8。注意
客户端地址:https://github.com/anshooarora/extentreports-java/commits/master
服务端地址:https://github.com/anshooarora/extentx
安装过程,官方文档上比较消息。
官方说明在这里:http://extentreports.com/docs/versions/3/java/, 提供了3种和testng集成示例:
1.直接在@BeforeSuite和@BeforeClass进行初始化
2.自己实现testng的ITestListener接口,监听的适合你已经有测试狂简了,不想动原来的case
3.自己实现testng的IReporter接口,更加直观
以上随便选择一种都可以,实现ITestListener接口。内容类似下面:
public class ExtentTestNGITestListener implements ITestListener {
private static ExtentReports extent = ExtentManager.getInstance("test-output/extent.html");
private static ThreadLocal test = new ThreadLocal();
public static MacacaClient driver;
@Override
public synchronized void onStart(ITestContext context) {
}
@Override
public synchronized void onFinish(ITestContext context) {
extent.flush();
}
@Override
public synchronized void onTestStart(ITestResult result) {
test.set(extent.createTest(result.getMethod().getMethodName()));
}
@Override
public synchronized void onTestSuccess(ITestResult result) {
((ExtentTest)test.get()).pass("Test passed");
}
@Override
public synchronized void onTestFailure(ITestResult result) {
((ExtentTest)test.get()).fail(result.getThrowable());
File directory = new File("test-output");
try {
String screenPath = directory.getCanonicalPath() + "/";
File file = new File(screenPath);
if (!file.exists()){
file.mkdirs();
}
String fileName = result.getMethod().getMethodName() + ".png";
driver.saveScreenshot(screenPath + fileName);
((ExtentTest)test.get()).addScreenCaptureFromPath(screenPath + fileName);
} catch (Exception e) {
e.printStackTrace();
}
}
@Override
public synchronized void onTestSkipped(ITestResult result) {
((ExtentTest)test.get()).skip(result.getThrowable());
}
@Override
public synchronized void onTestFailedButWithinSuccessPercentage(ITestResult result) {
}
}
onTestFailure函数里面实现了出错自动截图,调用的是ExtentTest的addScreenCaptureFromPath方法。
ExtentManager用来做初始化:
public class ExtentManager {
private static ExtentReports extent;
public static ExtentReports getInstance(String filePath) {
if (extent == null)
createInstance(filePath);
return extent;
}
public static void createInstance(String filePath) {
extent = new ExtentReports();
extent.setSystemInfo("os", "Linux");
extent.attachReporter(createHtmlReporter(filePath), createExtentXReporter());
}
public static ExtentHtmlReporter createHtmlReporter(String filePath){
ExtentHtmlReporter htmlReporter = new ExtentHtmlReporter(filePath);
//报表位置
htmlReporter.config().setTestViewChartLocation(ChartLocation.TOP);
//使报表上的图表可见
htmlReporter.config().setChartVisibilityOnOpen(true);
htmlReporter.config().setTheme(Theme.STANDARD);
htmlReporter.config().setDocumentTitle(filePath);
htmlReporter.config().setEncoding("utf-8");
htmlReporter.config().setReportName("XXX项目测试报告");
return htmlReporter;
}
public static ExtentXReporter createExtentXReporter() {
ExtentXReporter extentx = new ExtentXReporter("127.0.0.1",27017);
extentx.config().setProjectName("test1");
extentx.config().setReportName("Build-1224");
extentx.config().setServerUrl("http://localhost:1337");
return extentx;
}
ExtentXReporter构造函数里填的是mongodb的地址和端口。
在res/testng.xml里面注册这个监听器,测试类也写上:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="Suite">
<listeners>
<listener class-name="com.util.extent.ExtentTestNGITestListener"></listener>
</listeners>
<test name="Test">
<classes>
<class name="macaca.client.ExtentTestNGReportBuilder"></class>
</classes>
</test>
</suite>
测试类调用,随便写2个case演示:macaca是阿里的自动化框架,也不错的,可以直接删除也行,内容罢了
public class ExtentTestNGReportBuilder {
MacacaClient driver = new MacacaClient();
@BeforeClass
public synchronized void beforeClass() throws Exception {
JSONObject porps = new JSONObject();
porps.put("platformName", "android");
porps.put("reuse", 1);
porps.put("app", "https://npmcdn.com/android-app-bootstrap@latest/android_app_bootstrap/build/outputs/apk/android_app_bootstrap-debug.apk");
JSONObject desiredCapabilities = new JSONObject();
desiredCapabilities.put("desiredCapabilities", porps);
driver.initDriver(desiredCapabilities);
ExtentTestNGITestListener.driver = driver;
}
@AfterClass
public synchronized void afterClass() throws Exception{
driver.quit();
}
@Test
public void test_1() throws Exception{
assert 1==0;
}
@Test
public void test_2() {
assert 1 == 1;
}
}
运行命令
mvn clean test
开始测试
只查看失败的case:
Dashboard页面:
看看服务端的报告(运行了多次):
汇总页面:
这里的PROJECT和BUILD是ExtentManager类里面
extentx.config().setProjectName("test1");
extentx.config().setReportName("Build-1224");
这里设定的,这里实际使用时可以用jenkins集成时直接由jenkins传进来
如果觉得这种报告太笨重了,可以看下这种
https://www.jianshu.com/p/ce09d3bd1c37
轻量级别的
ps:所有酷炫的测试报告,都不适合发邮件,因为内容太多了
适合发邮件的模板去掉各种渲染