Robot Framework 常用关键字（2-1）

*** Settings ***
Library AppiumLibrary
Library AutoItLibrary
Library os

*** Keywords ***
xpath应该匹配次数
[Arguments] ${xpath} ${count}
Xpath Should Match X Times ${xpath} ${count}

上传文件
[Arguments] ${path} ${data} ${encode}=base64
Push File ${path} ${data} ${encode}

元素不应该包含文本
[Arguments] ${locator} ${expected} ${msg}=
Element Should not Contain Text ${locator} ${expected} ${msg}

元素值应该是
[Arguments] ${locator} ${expected}
Element Value Should Be ${locator} ${expected}

元素名应该是
[Arguments] ${path} ${name}
Element Name Should Be ${path} ${name}

元素属性应该匹配
[Arguments] ${locator} ${attr_name} ${match_pattern} ${regx}=False
Element Attribute Should Match ${locator} ${attr_name} ${match_pattern} ${regx}

元素应该包含文本
[Arguments] ${locator} ${expected} ${msg}=None
Element Should Contain Text ${locator} ${expected} ${msg}

元素应该失效
[Arguments] ${locator} ${level}=INFO
Element should be disabled ${locator} ${level}

元素应该有效
[Arguments] ${locator} ${level}=INFO
Element should be enabled ${locator} ${level}

元素文本应该是
[Arguments] ${locator} ${expected} ${msg}=None
Element Text Should Be ${locator} ${expected} ${msg}

关闭当前应用
Close Application

关闭所有应用
Close All Applications

切换应用
[Arguments] ${index_or_alias}
Switch Application ${index_or_alias}

切换页面内容
[Arguments] ${webview}
Switch To Context ${webview}

卸载应用
[Arguments] ${application_id}
Remove Application ${application_id}

后台运行
[Arguments] ${sec}
Background App ${sec}

向上滚动
[Arguments] ${locator}
Scroll Up ${locator}

向下滚动
[Arguments] ${locator}
Scroll Down ${locator}

失败后运行关键字
[Arguments] ${keyword}
[Documentation] Example: # Disables run-on-failure functionality and stores the previous kw name in a variable. # Restore to the previous keyword.
…
… Register Keyword To Run On Failure \ \ \ Log Source
… \ \ \ \ \ \ \ # Run Log Source on failure.
…
… ${previous kw}=
… Register Keyword To Run On Failure \ \ Nothing
…
…
… Register Keyword To Run On Failure \ \ \ \ ${previous kw} \ \ \
Register Keyword To Run On Failure ${keyword}

打印资源
[Arguments] ${level}
Log Source ${level}

打开URL
[Arguments] ${url}
[Documentation] Example:
…
… 打开应用
… http://localhost:4755/wd/hub \ platformName=iOS \ platformVersion=7.0
… deviceName=‘iPhone Simulator’
… browserName=Safari
…
… 打开URL \ http://m.webapp.com
Go To URL ${url}

打开应用
[Arguments] ${url} ${platformName} ${version} ${deviceName} ${app}
[Documentation] 打开应用 ${url} ${platformName} ${version} \ \ ${devicename} ${app} @{args}
…
… 例如：
…
… 打开应用 http://localhost:4723/wd/hub Android 5.1.1 5e25d20d $CURDIR${/}app${/}fft.apk
…
… ${url} 是用于访问应用的地址，一般是固定的。 url 和 端口可以根据具体地址修改。
… ${version} \ 是安卓的版本
… ${devicename} 是手机的UDID, 可以打开cmd 然后用 adb devices -l \ 看到设备列表。
… UDID 是看到的第一列的内容，真机是一串字符串，模拟器是 \ ip:port \ 的形式
… ${app} 是apk 存放的路径 ${CURDIR} 系统变量，取得当前脚本路径。 ${/} 系统变量 ‘/’
open application $urlplatformName=${platformName} platformVersion=$versiondeviceName=${deviceName} app=${app}

按关键字
[Arguments] ${keycode} ${metastate}=None
Press Keycode ${keycode} ${metastate}

摇动手机
Shake

放大元素
[Arguments] ${locator} ${percent}=200% ${step}=1
Zoom ${locator} ${percent} ${step}

敲击元素
[Arguments] ${locator}
Tap ${locator}

横屏
[Documentation] 手机设置横屏
LANDSCAPE

清除文本
[Arguments] ${locator}
Clear Text ${locator}

滑动
[Arguments] ${start_x} ${start_y} ${end_x} ${end_y}
swipe ${start_x} ${start_y} ${end_x} ${end_y}

滚动
[Arguments] ${start_locator} ${end_locator}
[Documentation] 从一个元素滚动到另一个元素
Scroll ${start_locator} ${end_locator}

点击元素
[Arguments] ${locator}
Click Element ${locator}

点击元素坐标
[Arguments] ${coordinate_x} ${coordinate_y}
Click Element At Coordinates ${coordinate_x} ${coordinate_y}

点击固定点
[Arguments] ${x} ${y} @{args}
Click A Point ${x} ${y} @{args}

点击按钮
[Arguments] ${index_or_name}
Click Button ${index_or_name}

点击文本
[Arguments] ${text} ${exact_match}=false
[Documentation] 点击匹配到文本的元素：
…
… 点击文本 “text”
… 点击文本 “text” True
…
… 默认模糊匹配所有元素，可以设置成精确匹配。
… 如果可以匹配到两个或两个以上的元素，那么需要用 click Element 元素，去处理。
Click Text ${text} ${exact_match}

睡眠
[Arguments] ${sec}
sleep ${sec}

竖屏
PORTRAIT

等待页面元素出现
[Arguments] ${locator} ${timeout}=100 ${err}=None
Wait Until Page Contains Element ${locator} ${timeout} ${err}

等待元素出现文本
[Arguments] ${text} ${timeout}=10 ${err}=None
Wait Until Page Contains ${text} ${timeout} ${err}

等待页面不包含元素
[Arguments] ${locator} ${timeout}=10 ${err}=None
Wait Until Page Does Not Contain Element ${locator} ${timeout} ${err}

等待页面不包含文本
[Arguments] ${text} ${timeout}=10 ${err}=None
Wait Until Page Does Not Contain ${text} ${timeout} ${err}

缩小元素
[Arguments] ${locator} ${percent}=200% ${step}=1
Pinch ${locator} ${percent} ${step}

获取Appium超时时间
${timeout} Get Appium Timeout
[Return] ${timeout}

获取Web元素
[Arguments] ${locator}
[Documentation] 获取匹配的定位器的第一个元素：
…
… ${element} 获取Web元素 id=name
… 点击元素 ${element}
${element} Get Webelement ${locator}
[Return] ${element}

获取元素坐标
[Arguments] ${locator}
${location} Get Element Location ${locator}
[Return] ${location}

获取元素尺寸
[Arguments] ${locator}
${size} Get Element Size ${locator}
[Return] ${size}

获取元素属性
[Arguments] ${locator} ${name_or_value}
[Documentation] 获取元素属性：（name 或者 value)
… ${val} \ 获取元素属性 ${locator} ${name_or_value}
…
… 例如：
… ${val} 获取元素属性 id=xxxx name
… ${val} 获取元素属性 id=xxxx value
${val} Get Element Attribute ${locator} ${name_or_value}
[Return] ${val}

获取匹配xpath数
[Arguments] ${xpath}
[Documentation] 例如：
…
… ${count} \ \ \ 获取匹配xpath数 \ \ //android.view.View[@text=‘Test’]
${count} Get Matching Xpath Count ${xpath}
[Return] ${count}

获取可见文本
${contents} Get Contexts
[Return] ${contents}

获取当前文本
${context} Get Current Context
[Return] ${context}

获取所有web元素
[Arguments] ${locator}
[Documentation] @{element} 获取所有web元素 id=my_element
… 点击元素 @{element}[2]
@{element} Get Webelements ${locator}
[Return] @{element}

获取文件
[Arguments] ${file_path} ${decode}=False
pull file ${file_path} ${decode}

获取文件夹
[Arguments] ${folder_path} ${decode}=False
Pull Folder ${folder_path} ${decode}

获取文本
[Arguments] ${locator}
[Documentation] 获取符合元素的文本：
… ${text} \ 获取文本 \ //*[contains(@text,‘foo’)]
${text} Get Text ${locator}
[Return] ${text}

获取网络连接情况
${stat} Get Network Connection Status
[Return] ${stat}

获取资源
${source} Get Source
[Return] ${source}

设置Appium超时
[Arguments] ${sec}
Set Appium Timeout ${sec}

设置网络连接状态
[Arguments] ${sec}
Set Network Connection Status ${sec}

输入值
[Arguments] ${locator} ${val}
Input Value ${locator} ${val}

输入密码
[Arguments] ${path} ${passwd}
Input Password ${path} ${passwd}

输入文本
[Arguments] ${path} ${text}
Input Text ${path} ${text}

返回
[Documentation] 浏览器返回上一个的页面
Go Back

重置应用
Reset Application

锁屏
[Arguments] ${sec}
[Documentation] 这个方法只使用于IOS
Lock ${sec}

长按元素
[Arguments] ${locator}
Long Press ${locator}

长按关键字
[Arguments] ${keycode} ${metastate}=None
[Documentation] keycode 可以在这个网址里面找到：
… http://developer.android.com/reference/android/view/KeyEvent.html.
…
… Args:
… \ \ \ \ - keycode - the keycode to be sent to the device
… \ \ - metastate - meta information about the keycode being sent
Long Press Keycode ${keycode} ${metastate}

隐藏键盘
Hide Keyboard

页面不应该包含元素
[Arguments] ${locator} ${lvl}=INFO
Page Should Not Contain Element ${locator} ${lvl}

页面不应该包含文本
[Arguments] ${locator} ${lvl}=INFO
Page Should Not Contain Text ${locator} ${lvl}

页面应该包含元素
[Arguments] ${locator} ${lvl}=INFO
Page Should Contain Element ${locator} ${lvl}

页面应该包含文本
[Arguments] ${locator} ${lvl}=INFO
Page Should Contain Text ${locator} ${lvl}

页面截图
[Arguments] ${filename}=
Capture Page Screenshot ${filename}