macaca-repo 基于 java-junit5 的 Macaca 测试报告

macaca-reporter-java-plugin (基于java-junit5的macaca测试报告)

目前mcaca-reporter对java的测试代码没有很好的支持,公司目前的自动化一直使用macaca配合java和junit5进行,在这基础上,

为支持开源,对macaca-reporter进行了一些研究,试图在java的基础上开发出一个适用于java的macaca测试报告。

目前我们产出了第一个版本,也就是当前的 macaca-reporter-java-plugin 。报告效果如下:

(图1,据说适当打码有益身心健康)

macaca-repo 基于 java-junit5 的 Macaca 测试报告

(图2)

macaca-repo 基于 java-junit5 的 Macaca 测试报告

(图3)

macaca-repo 基于 java-junit5 的 Macaca 测试报告

如何使用macaca-reporter-java-plugin

因为我们目前是基于junit5进行开发,所以第一步你可能要在你的测试代码中引入junit5

一、 pom.xml 引入 junit5

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.6.0</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-params</artifactId>
    <version>5.6.0</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.6.0</version>
    <scope>test</scope>
</dependency>

二、引入macaca-reporter-java-plugin

<dependency>
    <groupId>com.macacajs</groupId>
    <artifactId>macaca-reporter-java-plugin</artifactId>
    <version>1.0</version>
</dependency>

如果你已经使用了junit5完成了你的测试代码,不妨直接运行尝试一下结果。

如果你需要使用junit5开始改造你的代码,你可能需要了解下junit5。

junit5官方文档

macaca-reporter-java-plugin实现原理源于官方文档的 6.1.5章节

三、开始改造你的代码

监听用例状态并给错误截图

建议使用junit5的 @DisplayName 特性,你可以通过给用例添加该注解配置用例对应的标题,在用例失败的时候使用getDisplayName方法去命名错误图片

用例如果失败,macaca-reporter-java-plugin将通过当前工程的目录 ./screenshot 下去获取图片名,并通过DisplayName去比对,找到对应的图片转换为Base64图片码保存到报告中。

junit5监听用例状态,并截图参考方法:

@ExtendWith(BaseTest.class)
public class BaseTest  implements TestWatcher {
      @BeforeAll
      static void beforeAll() { ... }
      @BeforeEach
      void setUp() { ... }
      @Test
      @DisplayName("失败的用例")
      void name() { ... }
      @AfterEach
      void tearDown() { ... }
      @AfterAll
      static void afterAll() { ... }
      @Override
      public void testFailed(ExtensionContext context, Throwable cause) {
         //截图方法。
         saveScreen(context.getDisplayName()+"_"+new SimpleDateFormat("yyyy_MM_dd_HH_mm_ss").format(new Date()));
      }          
}

四、执行测试

因为macaca-reporter-java-plugin是以maven插件的形式开发,建议通过idea增加Maven执行配置去便捷执行。

指定计划名

mvn执行配置增加 (默认名:Macaca测试报告)

-DplanName=测试计划报告

指定Current Screen图

mvn执行配置增加 (不需要可忽略)

-Dlogo=http://www.logo.png

mvn执行配置参考

(添加入口)

macaca-repo 基于 java-junit5 的 Macaca 测试报告

(参考)

macaca-repo 基于 java-junit5 的 Macaca 测试报告

测试报告生成位置

测试执行完毕,你会在当前工程目录中发现多出一个 report.js 文件,和一个 /reports 目录。

report.js查看你会发现这里边储存的就是macaca-reporter所需要的json数据, 你也可以尝试修改report.js中json的数据,然后在当前目录执行 macaca-reporter -d report.js 命令然后检查测试报告的变化。

/reports目录下自动生成的 index.html ,就是我们的测试报告了,你可以使用浏览器直接打开查看。

五、运行结果(根据上图配置)

macaca-repo 基于 java-junit5 的 Macaca 测试报告

开源仓库

macaca-reporter-java-plugin

问题&建议

如果你在使用过程中出现了什么问题,或者有好的建议可以在仓库中以issue的方式反馈给我们,

或者在Macaca开源社区钉钉群中可以联系到我们 钉钉群号(11775486)@鸟帅 @石 星

原文 

https://testerhome.com/topics/22986

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » macaca-repo 基于 java-junit5 的 Macaca 测试报告

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址