RPALite

在 Robot Framework 中使用 RPALite 库

可以通过以下链接直接跳转到对应的部分:

安装

你可以通过 pip 安装 RPALite:

pip install RPALite

导入 RPALite 库

你可以通过以下代码导入 RPALite 库:

Library    RPALite

程序应用操作

启动应用

你可以使用以下代码启动一个应用:

Run Command    notepad.exe

查找应用

你可以使用以下代码查找一个应用:

${app} =    Find Application    .*Notepad

Find Application支持通过以下参数查找一个应用:

关闭应用

你可以使用以下代码关闭一个应用:

${app} =    Find Application    .*Notepad
Close App

最大化窗口

要最大化一个程序,首先你需要找到该程序(参照 查找应用),之后调用Maximize Window方法:

${app} =     Find Application    .*Notepad
Maximize Window    ${app}

## 模拟鼠标操作

RPALite 支持通过多种鼠标模拟操作,譬如点击文本,点击图片,点击坐标等

### 按坐标点击

你可以使用以下代码点击坐标:

```robotframework
Click By Position    10    20

点击文本

Click By Text    Text to click

点击图片

你可以使用以下代码点击图片:

Click By Image    path/to/image.png

模拟键盘操作

在当前光标位置输入文本

你可以使用以下代码输入一段文本:

Input Text    This is a demo using RPALite.

发送按键

你可以使用以下代码模拟按下键盘上的某个键:

Send Keys    {VK_LWIN down}D{VK_LWIN up}

全局操作

休眠

你可以使用以下代码模拟程序休眠:

Sleep    1

Sleep函数接受一个整数参数,表示 RPALite 需要休眠多少秒。这个参数是可选的,默认值是 rpalite 对象的step_pause_interval属性。

我们前面讲过,这个值不能设定为 0,因为在鼠标或者键盘模拟动作以后,Windows 或者你所操作的程序本身也需要一点时间进行响应,否则程序出问题的可能性会大大增加。如果你将这个参数设定为 0,RPALite 会直接使用step_pause_interval的值。如果你将 RPALite 的step_pause_interval属性设定为 0,那么 RPALite 会直接跳过休眠操作。

显示桌面

Show Desktop

获取屏幕尺寸

${size} = Get Screen Size
${log_message} =  Format String    Screen size: {0} ${size}
Log    ${log_message}

get_screen_size函数返回一个元组,表示屏幕的尺寸。例如 (1920, 1080) 表示屏幕宽度为 1920 像素,高度为 1080 像素。

屏幕截图

${pil_image} =    Take Screenshot

Take Screenshot函数返回一个 PIL 图像对象,表示当前屏幕的截图。它有两个可选的参数:

录屏

开始录屏

Start Screen Recording

Start Screen Recording函数会启动录屏功能,并开始录制屏幕。它有两个可选参数:

start_screen_recording 目前只支持保存为 AVI 格式的录屏文件。

结束录屏

Stop Screen Recording