转载

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）

（图3）

如何使用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()));
      }          
}