对appiumLibrary的关键字进行重命名，翻译工作
*** Keywords ***
###常用appiumLibrary 关键字翻译，及示例
打开app
Open Application http://localhost:4723/wd/hub platformName=Android
... platformVersion=8.0.0 deviceName=Android Emulator
... automationName=appium appPackage=com.example.notes
... appActivity=.Activity.MainActivity
wait until page contains element com.example.notes:id/fab_expand_menu_button
关闭app
quit application
程序放置后台几秒
[Arguments] ${TIME}
background app second = ${TIME} #second = 5
截取当前页面并放置在logzhong
Capture Page Screenshot
清空文本
[Arguments] ${locator}
clear text ${locator} #自动识别为id和xpath，xpath要已//开头,后面包含locator参数的使用方法一致
点击位置
[Arguments] ${locator}
Click Element ${locator}
点击按钮
[Arguments] ${index_or_name}
Click Button ${index_or_name} #按钮有名称才好使用，不建议使用，建议使用上面的
点击 #可以多次点击
[Arguments] ${locator} ${x_offset}=None ${y_offset}=None
... ${count}=1
Tap ${locator} ${count}
关闭所有程序
Close All Applications
##验证相关操作
验证 ${locator} 是禁用的
Element Should Be Disabled ${locator}
验证 ${locator} 是可用的
Element Should Be Enabled ${locator}
验证 ${locator} 的name是 ${string}
Element Name Should Be ${locator} ${srting}
#举例
# Element Name Should Be xpath = //*[contains(@text,'example text')] txt_field_name
验证 ${locator} 是可见的
Element Should Be Visible ${locator}
验证文本 ${text} 应是可见的
Text Should Be Visible ${text}
验证 #最通用的
[arguments] ${locator} ${attribute} ${string}
Element Attribute Should Match ${locator} ${attribute} ${string}
#举例
# Element Attribute Should Match xpath = //*[contains(@text,'example text')] name txt_field_name
#安卓支持的属性名称：contentDescription，text，className，resourceId，enabled，checkable，checked，clickable，focusable，focused，longClickable，scrollable，selected，displayed
验证 ${locator} 包含text ${text}
Element Should Contain Text ${locator} ${text}
验证 ${locator} 不包含text ${text}
Element Should Not Contain Text ${locator} ${text}
验证 ${locator} 的text应该是 ${text}
Element Text Should Be ${locator} ${text}
验证 ${locator} 的value应该是 ${value}
Element Value Should Be ${locator} ${text}
####获取相关值或者对象
获取当前的Activity
Get Activity #返回当前的activity
获取当前appium的SessionId
Get Appium SessionId #当前appium的SessionId作为参考
获取当前上下文
Get Current Context
获取可用的上下文 #查看源码发现两者返回的是同一个东西
Get Contexts
获取属性值
[Arguments] ${locator} ${attribute}
Get Element Attribute ${locator} ${attribute}
#举例：Get Element Attribute locator name
####操作
返回 #从历史记录中返回上一步
Go Back
前往网址${Url}
Go To Url ${Url}
隐藏键盘 #只可在ios上使用，安卓上没有可用的参数去操作
[Arguments] ${key_name】
Hide Keyboard ${key_name}
#输入操作
在 ${locator} 输入文本 ${text}
input text ${locator} ${text}
在 ${locator} 输入密码 ${password}
#与输入文本的区别是就是输入的密码日志不打印出来。正常没什么用，使用input text就可以
input password ${locator} ${password}
在 ${locator} 输入值 ${value}
#官方文档说只在ios上使用，但实际操作中android有的输入框上用input text输入不进去，用inputv alue却是成功的
input value ${locator} ${value}
横屏
Landscape
竖屏
Portrait
锁屏 #仅限ios
Lock
安装app
[Arguments] ${app_path} ${app_package}
install app ${app_path} ${app_package}
启动app
Launch Application #需要启动appium时选择app='路径地址'#写在用例中
退出程序
quit application #与Launch Application相对，用在测试用例中启动程序
Log记录当前页面或者框架的HTML源码
log source
长按 ${locator}
Long Press ${locator}
#判断页面包含，都可以设置日志等级，默认info。暂且不改动
页面应该包含 ${locator}
Page Should Contain Element ${locator}
页面不应该包含 ${locator}
Page Should Not Contain Element ${locator}
页面应该包含 ${text}
Page Should Contain Text ${text}
页面不应该包含文本${text}
Page Should Not Contain Text ${text}
缩小 #缩小一定量元素
[Arguments] ${locator} ${percent}=200% ${steps}=1
Pinch ${locator} ${percent} ${steps}
放大 #放大一定量元素
[Arguments] ${locator} ${percent}=200% ${steps}=1
Zoom ${locator} ${percent} ${steps}
摇晃设备
Shake
关键字失败时执行
Register Keyword To Run On Failure
#等待验证
等待活动
[Arguments] ${activity} ${timeout} ${interval}=1
wait activity ${activity} ${timeout}
#... interval-重试之间的休眠间隔，以秒为单位,默认1s
等待直到元件可见
[Arguments] ${locator} ${timeout}=None ${error}=None
Wait Until Element Is Visible ${locator} ${timeout} ${error}
#error 用于覆盖默认的错误消息，自定义错误消息
等待页面包含文本
[Arguments] ${text} ${timeout}=None ${error}=None
Wait Until Page Contains ${text}
等待页面不包含文本 #与上面相对
[Arguments] ${text} ${timeout}=None ${error}=None
Wait Until Page Does Not Contain ${text}
等待页面包含元件
[Arguments] ${locator} ${timeout}=None ${error}=None
Wait Until Page Contains Element ${locator}
等待页面不包含元件
[Documentation] 与Wait Until Page Contains Element相对
... timeout 表示超时时间
... error表示错误信息用于覆盖默认的，自定义错误信息
[Arguments] ${locator} ${timeout}=None ${error}=None
Wait Until Page Does Not Contain Element ${locator}
Xpath应该匹配几次
[Documentation] error表示错误信息用于覆盖默认的，自定义错误信息
... loglevel 用于设置日志等级
[Arguments] ${xpath} ${count} ${error}=None ${loglevel}=INFO
Xpath Should Match X Times ${xpath} ${count}
...未完待续...
