在 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 为例):
-
安装 Google Chrome 浏览器:
brew install --cask google-chrome
如果安装了可以忽略 -
安装 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:
-
安装 JDK:
brew install openjdk1
-
设置 Java 环境变量:
export JAVA_HOME=$(/usr/libexec/java_home)
-
安装 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 安装库,避免权限问题。
windows的cmd命令行,整理成可执…