Robot Framework 安装使用指南

内容目录

在 macOS 上安装和配置 Robot Framework 及其常用库的流程如下:

安装前的环境准备

安装 Python

Robot Framework 基于 Python,因此需要先安装 Python(推荐使用 Python 3.8 或更高版本)。

使用 Homebrew 安装 Python:

brew install python

检查 Python 是否安装成功:

python3 --version

确认返回正确的版本号(如 Python 3.x.x)。

安装 pip(Python 包管理工具)

Python 3 通常自带 pip,检查是否已安装:
pip3 --version

如果未安装,运行以下命令安装:
python3 -m ensurepip --upgrade

安装 Robot Framework

使用 pip 安装 Robot Framework:
pip3 install robotframework

验证安装是否成功:
robot --version

如路径错误,需要加入系统路径:
先确认robot 地址
python3 -m site --user-base
添加到系统路径,并刷新

echo 'export PATH=$PATH:/Users/[你的用户名]/Library/Python/3.12/bin' >> ~/.zshrc
source ~/.zshrc

安装常用库

安装 SeleniumLibrary(浏览器自动化)

SeleniumLibrary 是最常用的库,支持浏览器自动化。
安装 SeleniumLibrary:
pip3 install robotframework-seleniumlibrary

安装浏览器驱动(以 Chrome 为例):

  1. 安装 Google Chrome 浏览器:
    brew install --cask google-chrome
    如果安装了可以忽略

  2. 安装 ChromeDriver:
    brew install chromedriver

安装 BrowserLibrary(现代浏览器自动化,基于 Playwright)

BrowserLibrary 提供了基于 Playwright 的自动化功能。

安装 BrowserLibrary:
pip3 install robotframework-browser

安装 Playwright:
rfbrowser init

安装 RPA.Windows(桌面窗口操作,仅适用于 Windows)

由于 macOS 不支持 Windows 窗口操作,RPA.Windows 不适用于 macOS。

如果需要在 macOS 上进行类似的桌面窗口操作,可以考虑以下替代方案:

  • 使用图像识别库(如 SikuliLibrary)。
  • 远程连接到 Windows 机器运行相关操作。

安装 SikuliLibrary(图像识别操作)

SikuliLibrary 使用 Java 和 Jython,需要额外配置。

安装 SikuliLibrary:

  1. 安装 JDK:
    brew install openjdk1

  2. 设置 Java 环境变量:
    export JAVA_HOME=$(/usr/libexec/java_home)

  3. 安装 SikuliLibrary:
    pip3 install robotframework-sikulilibrary

安装其他库

以下是一些常用的辅助库:

  • 文件操作:OperatingSystem
    pip3 install robotframework-operatingsystem

  • 请求操作(HTTP 请求):RequestsLibrary
    pip3 install robotframework-requests

  • 图像识别:ImageHorizonLibrary
    pip3 install robotframework-imagehorizonlibrary

安装运行编辑器(可选)

安装 VS Code

VS Code 是一个非常流行的编辑器,支持 Robot Framework 的代码高亮和运行。

安装 VS Code:
brew install --cask visual-studio-code

在 VS Code 的扩展市场中安装:
Robot Framework Language Server(提供语法高亮和运行支持)

编写和运行 Robot Framework 测试用例

示例测试用例

创建一个文件 example.robot,内容如下:

*** Settings ***
Library           SeleniumLibrary
Library           OperatingSystem

*** Variables ***
${BASE_URL}       https://www.google.com
@{SEARCH_TERMS}    Robot Framework    Python    Selenium
${SCREENSHOT_DIR}    ./screenshots

*** Test Cases ***
Search Keywords And Validate Results
    Create Screenshot Directory
    Open Browser And Go To URL
    FOR    ${term}    IN    @{SEARCH_TERMS}
        Input Search Term And Submit    ${term}
        Validate Search Result          ${term}
        Capture Screenshot              ${term}
    END
    Close Browser

*** Keywords ***
Create Screenshot Directory
    Directory Should Not Exist    ${SCREENSHOT_DIR}
    Create Directory              ${SCREENSHOT_DIR}

Open Browser And Go To URL
    Open Browser    ${BASE_URL}    Chrome
    Maximize Browser Window
    Wait Until Page Contains Element    name=q    10s

Input Search Term And Submit
    [Arguments]    ${term}
    Input Text     name=q    ${term}
    Press Keys     name=q    RETURN
    Wait Until Page Contains    ${term}    10s

Validate Search Result
    [Arguments]    ${term}
    ${status}=    Run Keyword And Return Status    Page Should Not Contain    No results found for
    Run Keyword If    not ${status}    Fail    Search result for ${term} is missing!

Capture Screenshot
    [Arguments]    ${term}
    Capture Page Screenshot    ${SCREENSHOT_DIR}/${term}_result.png

运行测试用例

在终端中运行:

robot example.robot

遇到问题怎么办?

  • 无法找到浏览器驱动:
    确保安装了对应的浏览器驱动(如 ChromeDriver 或 GeckoDriver)。
  • 缺少依赖或权限问题:
    使用 pip3 install <库名> –user 安装库,避免权限问题。
浏览量(78) | 此条目发表在未分类分类目录。将固定链接加入收藏夹。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

这个站点使用 Akismet 来减少垃圾评论。了解你的评论数据如何被处理