RF+Allure生成漂亮的测试报告之环境搭建及简单使用

RobotFramework学习笔记目录

---

一、RobotFramework环境搭建

• 请参考文章：RobotFramework学习00-基本配置及初步使用

二、Allure安装

2.1 环境准备

• 需要java环境，否则安装allure时会出错
• 检查环境java -version，1.8以上版本。

2.2 安装allure

2.2.1 win下安装

1. 下载相关zip文档下载地址

版本选择

zip包选择

2. 将zip文档解压缩。
3. 切换到对应到bin目录。
4. 对于Windows运行allure.bat，对于其他Unix平台运行allure。
5. 将bin对应的目录E:\allure-2.13.0\bin添加到系统PATH中。(如果不加入到path中，则每次都必须在该目录下才可以执行allure相关命令)

2.2.2 mac下安装

brew install allure

2.2.3 linux下安装

For debian-based repositories a PPA is provided

sudo apt-add-repository ppa:qameta/allure
sudo apt-get update 
sudo apt-get install allure

2.2.4 验证安装是否成功

• 命令行窗口运行allure --version，如果可以运行并显示相应的版本号，则说明安装成功。

三、安装allure-robotframework

• 安装

pip install allure-robotframework

• 以上命令执行后，将会自动安装以下两个库

allure-python-commons
allure-robotframework

四、简单使用

4.1 示例代码

• robot测试用例

*** Test Cases ***
testcase1
    log  testcase1

testcase2
    log  testcase2
    should be true  1==2

testcase3
    log  testcase3

• 单独执行RF测试用例时的命令

robot test1.robot

4.2 RF+allure命令结合

4.2.1 生成allure格式的日志文件

1. 输出到默认目录output。（本文章采用此种方式）

robot --listener allure_robotframework test1.robot

2. 输出到指定目录myoutput

robot --listener allure_robotframework;myoutput test1.robot

allure格式的日志文件路径

4.2.2 根据allure格式的日志文件生成allure报告

• o ./allure-report：指定报告存放位置
• ./output/allure：allure格式的日志文件存放位置
• --clean：清空报告存放文件（如果历史已经生成过）

allure generate o ./allure-report ./output/allure --clean

allure报告的路径

4.2.3 打开allure报告

注：上一步执行后会生成相应的报告，但不支持直接在浏览器打开

1. 打开方式一：在pycharm中选择生成的index.html文件，右键选择Open in Brower的方式打开

通过pycharm打开报告

2. 打开方式二：运行以下命令，启动服务，此时将自动打开报告，也可以在浏览器中输入启动服务时给定的url，在浏览器打开。（推荐使用此方式打开）

allure open ./allure-report/

通过启动本地服务的方式打开报告

4.3 报告界面

• 查看报告

报告界面

• 报告界面可以选择语言

报告界面-切换语言

五、参考资料

1. allure官网
2. allure官方学习文档
3. 环境搭建之allure的安装配置，及简单使用
4. allure-robotframework
5. RobotFramework学习09-项目目录与执行参数