一、环境安装
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的集成
暂无，后续更新
