Allure使用手册

一. 简介

Allure是一款支持多语言的测试结果可视化软件，支持Java、Python，搭配Junit、pytest等测试框架食用更香。本文主要讲解搭配Junit4。

二. 下载、安装部署

2.1 下载

百度搜索Allure2！！！

敲重点：不是Allure，allure默认搜出来的是一款游戏，也是在github上的开源项目，别问我怎么知道！！！

https://github.com/allure-framework/allure2

或者去下面的链接直接下载zip，版本请自行斟酌

Central Repository: io/qameta/allure/allure-commandline

2.2 安装部署

zip包直接解压下来就能用，但是，为了方便，还是加入到系统变量中吧

​​​​​​​

 

cmd中输入allure --version，安装成功并添加好系统变量的话，会输出你安装的版本号。

三. 测试代码工程搭建

Allure Framework

可参考allure官方文档进行pom文件的设置，其中maven-surefire-plugin与里面的配置是为了在执行mvn test之后，在target目录下生成surefire-reports目录与项目工程目录下生成allure-results文件夹。surefire-reports是maven插件自动生成的测试结果文件夹，如果不考虑使用allure的注解修改报告内容，可以用该结果生成allure报告。allure-results也是测试结果文件夹，里面会包含有在代码中的注解信息，注解用于优化测试报告，也可以用该结果生成报告。

四. 命令行启动

首先需要mvn test执行测试用例，并生成测试结果文件夹和文件

4.1 静态报告

在工程目录下执行allure generate allure-results，会自动在工程目录下生成allure-report目录，这就是静态报告，主页是index.html

4.2 报告服务

在工程目录下执行allure serve allure-results，会自动启动allure的web服务，自动弹出主页

五. 修改报告内容

注解内容详情还是请大家参考官方文档Allure Framework

5.1 代码注解

常用注解：

    @Test
    @DisplayName("用例名称")
    @Description("用例描述")
    @Link("用例链接")
    @Issue("用例问题")
    //用例等级
    @Severity(SeverityLevel.MINOR)
    public void testCase3() {
        ...
    }

5.2 logo与标题修改

将图标放置在Allure\allure-2.17.2\plugins\custom-logo-plugin\static目录下，然后修改styles.css样式文件，将图片文件名替换到url后面，还可以适当的修改样式，同时也可以清除掉标题文字，例如下面的.side-nav__brand span先选取到文字的标签，再设置display为none，如果还想要自定义文字，则可以在后面继续加样式

.side-nav__brand {
  background: url('LOGO.png') no-repeat left center !important;
  margin-left: 31px;
  width: 100px;
  height: 80px;
}

.side-nav__brand span{
  display: none;
}
.side-nav__brand:after{ 
  content: "你的文字"; 
  margin-left: 18px;
  height: 20px; 
  font-family: kai;
  font-size: 13px; 
}

修改完成后还需要将该插件注册进allure中，Allure\allure-2.17.2\config目录下编辑allure.yml文件，最后一行添加- custom-logo-plugin

最后重启allure web服务就可以看到变化啦

最后敲重点！！！详情请参考视频自学【测吧】Junit结合下一代测试报告框架Allure2_哔哩哔哩_bilibili