RobotFramework安装与最小用例跑通测试

萝卜青菜_
236 阅读6分钟

没什么前言，主要是记录一下安装RobotFramework时踩的一些坑，做一些记录。

安装教程（Python、RobotFramework+Web测试库）

1.安装python环境

直接搜索python官网即可安装python，确保电脑已安装 Python（3.6 及以上版本，推荐 3.8/3.9，兼容性更好），安装后需配置环境变量（Windows 需勾选 “Add Python to PATH”，Mac/Linux 默认已配置）。

  • 验证 Python 是否安装成功：打开命令行（CMD / 终端），输入 python --version（Windows）或 python3 --version（Mac/Linux），能显示版本号即成功。

2.安装核心依赖库

RobotFramework需要安装3个核心依赖库，直接使用命令行即可：

库名称作用说明安装命令（CMD/终端）
robotframeworkRobot Framework 核心框架pip install robotframework
robotframework-seleniumlibraryWeb UI 自动化核心库（操作浏览器、页面元素）pip install robotframework-seleniumlibrary
selenium浏览器驱动依赖（控制 Chrome/Firefox 等）pip install selenium

3.浏览器驱动(Chrome)

  • 步骤 1：查看 Chrome 浏览器版本（打开 Chrome → 右上角三个点 → 帮助 → 关于 Google Chrome），比如 “120.0.6099.109”。

  • 步骤 2：下载对应版本的 ChromeDriver 驱动

  • 下载地址：sites.google.com/chromedrive…（科学上网）；或国内镜像：registry.npmmirror.com/binary.html…

  • 选择与 Chrome 版本匹配的驱动（大版本一致即可，比如 Chrome120 对应 ChromeDriver120），根据你的系统（Windows/Mac/Linux）下载对应压缩包。

  • 步骤 3：配置驱动环境

    • 解压压缩包，得到chromedriver.exe（Windows）或chromedriver（Mac/Linux）可执行文件；

    • 配置方式（二选一，推荐方式 1 更简单）：

      • 方式 1：将驱动文件放到 Python 的安装目录下（可通过where python（Windows）/ which python3（Mac/Linux）查询安装路径）；
      • 方式 2：将驱动文件路径添加到系统环境变量中。
  • 步骤4：验证驱动：命令行输入 chromedriver --version（Windows/Mac/Linux），能显示版本号即配置成功。
高版本浏览器驱动下载

注意：有些浏览器的版本比较高，比如我的Chrom版本为：143.0.7499.170，对于高版本的浏览器驱动，需要使用下面的地址来下载驱动（Stable稳定版即可）。

googlechromelabs.github.io/chrome-for-…

image.png

4.安装编辑器（RIDE）

RIDE 是 Robot Framework 官方推荐的编辑器，可视化操作，降低上手难度：

  • 安装命令：pip install robotframework-ride
  • 启动 RIDE：命令行输入 ride.py（Windows）或 python3 -m robotide.ride（Mac/Linux），等待片刻即可打开编辑器（首次启动可能较慢）。
ride.py无法打开RIDE编辑器

ride.py命令无法识别，本质是 RIDE 的可执行脚本安装在 Python 的Scripts目录下，而该目录未被添加到 Windows 系统环境变量中，系统无法找到该命令。因此，需要手动配置环境变量：

步骤1：找到python的安装目录

  • 执行命令查询 Python 核心安装路径：
where python
  • 输出结果中，复制 Python.exe 所在的目录（示例：C:\Python39\python.exe → 路径为C:\Python39）；
  • 在该目录下，直接找到「Scripts」文件夹（路径示例：C:\Python39\Scripts）。

步骤2：配置环境变量

  • 右键点击「此电脑」→ 「属性」→ 「高级系统设置」→ 「环境变量」；
  • 在「系统变量」列表中，找到并双击「Path」变量；
  • 点击「新建」，将第一步找到的「Scripts」目录路径（示例：C:\Python39\Scripts）粘贴进去；
  • 点击「确定」保存所有配置（需逐层点击确定，确保配置生效）；

关键步骤：关闭当前所有 CMD 窗口，重新打开一个新的 CMD 窗口（环境变量配置需重启命令行才能生效）；

此时执行 ride.py 命令，即可正常启动 RIDE。

最小用例跑通测试（Baidu）

最小运行用例将实现功能：打开 Chrome 浏览器 → 访问百度首页 → 点击搜索输入框 → 输入 “Robot Framework 实操” → 点击百度一下按钮 → 关闭浏览器。

步骤1：创建项目结构

  • 打开 RIDE 后，点击顶部菜单栏「File」→「New Project」；
  • 填写项目名称：比如 “RF_Web_Demo”，「Type」选择 “Directory”（目录类型），点击「OK」；
  • 右键点击刚创建的项目「RF_Web_Demo」→「New Test Suite」，填写套件名称：比如 “Web_Test_Suite”，「Type」选择 “File”（文件类型），点击「OK」；
  • 右键点击测试套件「Web_Test_Suite」→「New Test Case」，填写用例名称：比如 “Baidu_Search_Demo”，点击「OK」；

此时项目结构为：RF_Web_Demo（项目）→ Web_Test_Suite（测试套件）→ Baidu_Search_Demo（测试用例）。

步骤 2：导入 Web 测试库（SeleniumLibrary）

  • 点击测试套件「Web_Test_Suite」（左侧列表），切换到右侧「Imports」标签页；
  • 点击下方「Add Import」，在弹出的输入框中输入 SeleniumLibrary（必须完全一致，大小写敏感），点击「OK」；
  • 若导入后无红色报错，说明库导入成功（红色报错则检查库是否安装成功）。

步骤 3：编写测试用例（核心：调用关键字实现页面操作）

我们使用「关键字驱动」模式，直接调用 SeleniumLibrary 的内置关键字，无需编写原生 Python 代码，步骤如下：

  • 点击左侧测试用例「Baidu_Search_Demo」，切换到右侧「Test Case」标签页；
  • 该标签页是表格形式，分为「Keyword」（关键字）、「Argument」（参数，多个参数用空格 / 制表符分隔）两列，按以下表格依次添加行（点击表格下方「Add Row」添加行）：
行号Keyword（关键字）Argument（参数）作用说明
1Open Browserwww.baidu.com chrome打开 Chrome 浏览器，访问百度首页
2Maximize Browser Window-浏览器窗口最大化（可选，提升可视化效果）
3Click Elementid=chat-textarea点击百度搜索输入框（通过 id 定位元素）
4Input Textid=chat-textarea Robot Framework 实操向搜索输入框中输入指定内容
5Click Elementid=chat-submit-button点击 “百度一下” 按钮（通过 id 定位元素）
6Sleep3等待 3 秒（查看搜索结果，可选）
7Close Browser-关闭浏览器

参数说明

  • OpenBrowser中的参数为两个，分别需要填入两个表格中。对于RobotFramework来说，参数之间需要用两个空格隔开，不然会识别为一个参数。
  • 元素定位：我们用id定位（最简单稳定），百度搜索框的 id 是 “chat-textarea”，“百度一下” 按钮的 id 是 “chat-submit-button”（可通过 Chrome 开发者工具验证：F12 → 元素选择器 → 点击对应元素，查看属性）；
  • 关键字参数：Open Browser 后跟两个参数（网址 + 浏览器类型），Input Text 后跟两个参数（元素定位表达式 + 输入内容），无参数则填 “-”；
  • 关键字大小写不敏感，支持中文关键字（后续可自定义）。

完整的Robot脚本如下，可以参考：

*** Settings ***
Library    SeleniumLibrary

*** Test Cases ***
Baidu_search_Demo
    Open Browser    https://www.baidu.com    chrome    executable_path=D:\\DownloadDrivers\\chromedriver-win64\\chromedriver.exe
    Maximize Browser Window
    Wait Until Page Contains Element    id=chat-textarea
    Click Element    id=chat-textarea
    Input Text    id=chat-textarea    Robot Framework 实操
    Click Element    id=chat-submit-button
    Sleep
    Close Browser

步骤 4：运行测试用例，查看结果

  • 选中测试用例「Baidu_Search_Demo」，点击顶部菜单栏「Run」→「Run Test Case」（或直接点击工具栏绿色三角按钮）；

  • 运行过程中，会自动弹出 Chrome 浏览器，依次执行 “打开百度→点击输入框→输入内容→点击按钮” 的操作，等待 3 秒后关闭浏览器；

  • 查看运行结果：

    • RIDE 底部会显示运行状态（绿色表示成功，红色表示失败）；
    • 自动生成报告：在项目目录下，会生成output.xml（原始数据）、log.html（详细日志）、report.html（汇总报告）三个文件；
    • 双击打开report.html（用浏览器打开），可查看美观的可视化报告，包含每个步骤的执行结果、截图（失败时自动生成截图，成功时可配置生成截图）。
avatar
文章
阅读
粉丝