Allure2安装及运行

一、Allure2介绍

  • Allure是由Java语言开发的一个轻量级,灵活的测试报告工具;
  • Allure多平台的Report框架;
  • Allure支持多语言,包括Python、JavaScript、PHP、Ruby等;
  • 可以为开发/测试/管理等人员提供详尽的测试报告,包括测试类别、测试步骤、日志、图片、视频等;
  • 可以为管理层提供高水准的统计报告;
  • 可以集成到Jenkins生成在线的趋势汇总报告。

二、报告展示

2.1 首页展示

2.2 用例详情页

三、下载及安装

  1. 需要先安装 Java,配置环境变量;
    ①Java 安装贴(windows 系统):Java 环境安装
    ②Java 安装贴(mac 系统):Java环境准备帖-Mac

  2. 安装 Allure ,需要配置环境变量;
    详细安装步骤参考:Allure安装
    ①下载Allure源码包到本地;

  • 下载地址 1
  • 下载地址 2
    • mac/linux: 下载 tar
    • windows: 下载 zip
      ②配置环境变量:解压后将bin目录加入PATH环境变量;
      ③执行命令验证环境。
# 环境验证
allure --version

图片

  1. 安装插件。
    ①Python:pip install allure-pytest
    ②Java:Maven插件安装

四、运行方式

4.1 生成测试报告流程

image

4.2 使用Allure2运行方式(Python)

  • 使用–alluredir参数生成测试报告:
# 在测试执行期间收集结果
pytest [测试用例/模块/包] --alluredir=./result/  (—alluredir这个选项 用于指定存储测试结果的路径)

# 生成在线的测试报告
allure serve ./result

五、报告生成

  • 生成测试报告需要使用命令行工具 allure:
  • 命令格式:allure [option] [command] [command options]
# 步骤一:在测试执行期间收集结果
# —alluredir这个选项 用于指定存储测试结果的路径
pytest  [测试文件] -s –q --alluredir=./result/
# 如果要清除已经生成的报告的历史记录,可以添加参数--clean-alluredir
pytest  [测试文件] -s –q --alluredir=./result/ --clean-alluredir
# 步骤二:查看测试报告,注意这里的serve书写
allure serve ./result/

示例:
--clean-alluredir清理文件并重新生成

5.1 生成报告的两种方式

方式一:在线报告,直接打开默认浏览器,展示当前报告;

# 方式一:测试完成后查看实际报告,在线查看报告,会直接打开默认浏览器展示当前报告。
allure serve ./result/   (注意这里的serve书写)

方式二:静态资源文件报告(带index.html、css、js等文件),需要将报告部署到web服务器。
①应用场景:如果希望随时打开报告,可以生成一个静态资源文件报告,将这个报告部署到web服务器上,启动web服务,即可随时随地打开报告;
②解决方案:使用allure generate生成带有index.html的结果报告,这种方式需要两步:
a. 生成报告;
b. 打开报告。

# 生成报告
allure generate ./result
# 打开报告
allure open ./report/

  • index.html文件–右键菜单–Open in Browser,在浏览器中打开并查看报告


问题:

  • 运行mvn命令对应没有在target下面生成allure-results目录,怎么解决?
  • 解决方案:
    • 在src/test/resources路径下配置allure配置文件allure.properties,指名allure报告生成路径。
allure.results.directory=target/allure-resultsa

5.2 常用参数

  • allure generate 可以指定输出路径,也可以清理上次的报告录;
    • -o/ -output 输出报告的路径;
    • -c/ -clean 如果报告路径重复,可以清理;
  • allure open 打开报告。
    • -h/ -host 主机IP地址,此主机将用于启动报表的web服务器;
    • -p/ -port 主机端口,此端口将用于启动报表的web服务器,默认值为0。
# 生成报告,指定输出路径,清理报告。
allure generate ./result -o ./report --clean

# 打开报告,指定IP地址和端口。
allure open -h 127.0.0.1 -p 8883 ./report/