RobotFramework自动化测试框架-移动手机自动化测试AppiumLibrary库其它的常见自动化关键字

Posted 2020-10-03 张永清

关键字	使用描述
Close Application	关闭掉当前已经打开的APP Application，该关键字不需要接收任何的参数，但是使用该关键字的前提是已经打开了一个APP Application。
Close All Applications	关闭掉当前已经打开的所有的APP Application，该关键字不需要接收任何的参数。
Background App	让当前APP Application 运行在后台，该关键字接收一个参数[后台运行的时间]，示例： Background App 5s
Capture Page Screenshot	获取当前页面的截图，如果对该关键字没有传入任何的参数，会默认在将获取到的截图命名为appium-screenshot-<counter>.png，并且保存到RobotFramework的运行日志目录下，在案例运行失败时，经常需要保存截图来辅助定位和分析。
Set Appium Timeout	设置Appium的超时时间，该关键字接收一个参数[超时的时长，单位为秒]
Get Appium Timeout	获取不同关键字使用的超时时间。
Go Back	返回到浏览器的上一个操作步骤，相当于浏览器的后退按钮功能。
Go To Ur	在默认的浏览器上打开一个url地址，该关键字接收一个参数[待打开的url]
Hide Keyboard	隐藏当前操作设备的键盘，需要注意的是，该关键字在安卓手机上执行时，可以不需要加任何参数，在ios手机上执行时，可以使用` key_name `按特定的键。
Input Password	该关键字和Input Text关键字的功能基本一致，只是当使用该关键字时，日志中不会记录输入的password。
Input Value	该关键字只适用于iOS设备，可以接收两个参数[ locator | text ]
Lock	锁定手机设备
Long Press	该关键字用于模拟长按APP界面的某个元素，该关键字接收一个参数[ locator ]
Long Press Keycode	该关键字用于模拟长按手机设备上的一个按键，接收两个参数[ keycode | metastate=None ]，需要注意，该关键字只适用于安卓设备
Press Keycode	该关键字只适用于安卓设备，模拟对键盘上的按键进行操作。该关键字接收两个参数[ keycode | metastate=None ]，如模拟ctrl或者alt键。
Pull File	该关键字用于从手机设备上下拉文件，该关键字接收两个参数[ path | decode=False ]，path参数指的是设备上文件的路径，decode参数指的是否按照base64来解码，默认为false。
Pull Folder	该关键字和Pull File关键字用法很相似，该关键字接收两个参数[ path | decode=False ]，path参数指的是设备上文件的路径，decode参数指的是否按照base64来解码，默认为false。
Push File	该关键字的功能和Pull File关键字相反，用于向手机设备上传文件，该关键字接收三个参数[ path | data | encode=False ]，path参数指的是设备的路径，dat参数指的是待传入到设备上的文件，decode参数指的是否按照base64来编码，默认为false。
Remove Application	该关键字用于移除设备上的application，该关键字接收一个参数[ application_id ]，示例： Remove Application com.example.calculator
Register Keyword To Run On Failure	该关键字用于在案例执行失败时，需要执行哪个关键字。示例： Register Keyword To Run On Failure Log Source
Scroll	该关键字模拟屏幕滚动或者滑动，该关键字接收两个参数[ start_locator | end_locator ],可以模拟从一个元素滑动到另一个元素。
Scroll To	该关键字和Scroll关键字很类似。但是该关键字只接收一个参数[ locator ]
Shake	该关键字用于模拟摇动手机设备。
Swipe	模拟手机滑动，从一个点滑动到另一个点，该关键字接收5个参数[ start_x | start_y | end_x | end_y | duration=1000 ]，滑动时，点的定位采用坐标的形式。
Tap	该关键字模拟对屏幕元素进行点击，接收一个参数[ locator ]
Zoom	该关键字用于放大一个元素，接收三个参数[ locator | percent=200% | steps=1 ]，第一个参数为定位元素的方式，第二个参数为放大的百分比，如果不传入该参数的话，默认放大两倍。