一、安装(Windows系统手动安装)
1、从Maven Central下载最新版本的 zip 存档。
2、将存档解压缩到 allure-commandline 目录。
3、导航到bin目录。
4、Windows使用allure.bat或对其他 Unix 平台使用allure。
5、为allure配置系统PATH变量。
6、检查安装,cmd输入:allure --version
7、配置maven pom.xml文件,以Junit 4为例
<properties>
<aspectj.version>1.8.10</aspectj.version>
</properties>
<dependencies>
<dependency>
<groupId>io.qameta.allure</groupId>
<artifactId>allure-junit4</artifactId>
<version>LATEST_VERSION</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.20</version>
<configuration>
<testFailureIgnore>false</testFailureIgnore>
<argLine>
-javaagent:"${settings.localRepository}/org/aspectj/aspectjweaver/${aspectj.version}/aspectjweaver-${aspectj.version}.jar"
</argLine>
<properties>
<property>
<name>listener</name>
<value>io.qameta.allure.junit4.AllureJunit4</value>
</property>
</properties>
</configuration>
<dependencies>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>${aspectj.version}</version>
</dependency>
</dependencies>
</plugin>
</plugins>
</build>
- 设置allure报告目录(以maven项目为例)
方法1、使用 allure.properties 文件来配置 Allure
allure.results.directory=target/allure-results
allure.link.issue.pattern=https://example.org/browse/{}
allure.link.tms.pattern=https://example.org/browse/{}
文件存放位置:/test/resources
方法2、通过设置系统属性pom.xml
pom.xml
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.20</version>
<configuration>
...
<systemPropertyVariables>
<allure.results.directory>${project.build.directory}/allure-results</allure.results.directory>
<allure.link.issue.pattern>https://example.org/browse/{}</allure.link.issue.pattern>
<allure.link.tms.pattern>https://example.org/browse/{}</allure.link.tms.pattern>
</systemPropertyVariables>
</configuration>
...
</plugin>
</plugins>
</build>
- 执行测试
项目主目录运行mvn clean test (需要安装maven-surefire-plugin插件),然后会生成Junit 格式xml测试报告到target/surefire-reports目录,也会生成allure的测试数据到以下目录target\allure-results
- 生成测试报告
target目录下运行 allure serve命令,它根据在提供的路径中找到的数据在临时文件夹中生成一个报告,然后创建一个本地 Jetty 服务器实例,提供生成的报告并在默认浏览器中打开它,如下图:
参考文档: