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

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