一、环境安装

1. 介绍

allure是一个轻量级的，灵活的，支持多语言的测试报告工具
多平台，奢华的report框架
可以为dev/qa提供详尽的测试报告、测试步骤、log
也可以为管理层提供high level 统计报告
Java语言开发，支持pytest，JavaScrpit，PHP，ruby
可以集成到Jenkins

2. 安装

allure安装分为2块，如下：

allure-pytest库安装
本地生成报告并导出的命令行allure安装

2.1 pip命令行安装allure-pytest

pip install allure-pytest

2.2 安装命令行allure

安装jdk

参考：01_环境安装

注意：如上述链接无法打开，请在网上查询其他教程

访问allure下载地址进行下载，下载zip格式即可
解压allure压缩包，把压缩包复制到指定目录，进入文件夹bin中，双击其中的allure.bat文件，会有一个窗口一闪而过，说明已安装成功一半
配置allure的环境变量，在path中加入allure的bin目录地址
配置完成后，在cmd或者powershell中输入allure，显示如下说明安装allure成功

3. 使用

3.1 生成allure报告所需数据

pytest --alluredir=报告所需数据路径（绝对路径或者相对路径）

注意：存放allure报告所需数据的路径要和allure报告存放的路径分开，即不能一致

3.2 生成allure报告（根据打开allure报告方式决定是否执行此步骤）

allure generate -c -o 报告路径 报告所需数据路径

3.3 打开allure报告

打开报告有三种方式

3.3.1

使用allure serve命令

allure serve 报告所需数据路径

执行上述命令，allure报告会自动打开，显示如下：

3.3.2

allure generate生成html格式的测试结果报告，并使用allure open来打开报告

allure generate -c -o 报告路径 报告所需数据路径
allure open -h xxx -p xxx 报告路径

执行上述命令后，allure报告会自动打开，显示如下：

执行allure open命令会启动一个Web服务，将已经生成的html测试报告在默认的浏览器中打开，地址为指定的ip和port，如未指定，则会自动指定
注意：allure open命令可指定ip和port打开allure报告

3.3.3

上述两种打开方式都需要启动Web服务，否则无法打开allure报告，使用allure-combine会生成静态html报告（complete.html），不需要启动Web服务，即第三种打开allure报告，如下：

allure-combine 报告路径 --dest 报告路径

执行上述命令后，allure报告不会自动打开，显示如下：

注意：执行allure-combine命令前，需要先安装allure-combine

3.3.4 打开allure报告区别

allure serve和allure open方式都需要启动Web服务，否则无法打开allure报告，使用allure-combine会生成静态html报告（complete.html），不需要启动Web服务，执行完后点击complete.html文件，可直接查看报告
allure serve方式打开只需要生成allure报告所需数据，allure open方式不仅需要生成allure报告所需数据，且还要生成allure报告
allure open方式生成报告之后，点击报告所在目录的报告（index.html），不会正常显示报告，会一直显示loading，但是在pycharm中打开报告，报告内容可正常显示

参考：allure报告官方文档

4. 其他

4.1 allure报告环境配置

4.1.1 添加environment.properties文件来添加环境配置

打开报告之前，在下述路径中（报告所需数据路径）创建environment.properties文件，格式如下：

pytest --alluredir=报告所需数据路径（绝对路径或者相对路径）

host=10.10.10.10
branch=1.0.0
level=SMOKE_TEST

注意：文件名固定，不可更改

执行打开报告命令，显示如下：

二、allure与jenkins的集成

暂无，后续更新

11_Allure报告