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

关键字

使用描述

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 ]，第一个参数为定位元素的方式，第二个参数为放大的百分比，如果不传入该参数的话，默认放大两倍。