元素定位方式
框架支持name
、id
、xpath
、classname
4种方式获取元素,我们做了一定简化…. 另外,我们新加入了OCR图片识别查找元素😀
元素类型 | 举例 |
---|---|
name | click(‘搜索’) |
id | click(‘com.taobao.taobao:id/searchEdit’) |
xpath | click(‘//*[@resource-id=”com.taobao.taobao:id/searchEdit”]’) |
classname | click(‘android.widget.EditText’) |
image(目前只针对图片) | click(${logo}) (data.yaml文件中resource有配置logo) |
单击(tap)
tap
单击某一坐标,参数为元素坐标( x
y
)
- tap(100,100)
双击(doubleTap)
doubleTap
双击某一坐标,参数为元素坐标( x
y
)
- doubleTap(100,100)
长按(press)
press
长按某一坐标,参数为元素坐标以及时间( x
y
s
)
- press(100,100)
- press(100,100,2)
点击(click)
click
点击指定元素,参数: element
或者图片地址
- click('name')
- click(${logo}) # logo: "Resources/logo.png"
检查(check)
check
查找指定元素,参数: element
或者图片地址
- check('name')
- check(${logo}) # logo: "Resources/logo.png"
输入(input)
input
输入指定内容,参数: element
, text
- input('name','http://github.com')
滑动(swipe)
swipe
向指定坐标滑动,参数为坐标&持续时间fromx
,fromy
,tox
,toy
,during
,默认:2 ,也可以指定具体方向up
, down
, left
, right
- swipe(100,100,200,200)
- swipe('down')
获取文字$($.getText)
$.getText
获取当前元素的text,参数: element
- ${text} = $.getText('com.taobao.taobao:id/home_searchedit') #获取淘宝首页输入框中的文案
获取单个元素($.getElement)
$.getElement
获取单个元素,参数: element
- ${element_id} = $.getElement('name')
获取多个元素($.getElements)
$.getElements
获取单个元素,参数: element
- ${elements_class} = $.getElements('name')
判断元素是否存在($.isExist)
$.isExist
判断元素是否存在,参数: element
- ${element_id} = $.isExist('name')
- if ${element_id}:
- sleep(1)
判断元素是否不存在($.isNotExist)
$.isNotExist
判断元素是否不存在,参数: element
- ${element_id} = $.isNotExist('name')
- if ${element_id}:
- sleep(1)
判断(平台ifiOS/ifAndroid)
ifiOS
ifAndroid
判断 platformName
参数是否为 iOS
或者 Android
- ifiOS:
- click('iOS')
- ifAndroid:
- click('Android')
启动应用(launchApp/only Android)
launchApp
打开应用,默认参数为config
中activity
,暂时支持 Android
端
- launchApp('com.taobao.taobao/com.taobao.tao.TBMainActivity')
关闭应用(closeApp/only Android)
closeApp
关闭应用,默认参数为config
中package
, 暂时支持 Android
端
- closeApp('com.taobao.taobao')
adb(adb/only Android)
adb
命令,仅支持 Android
端
- adb('input text hello')
返回(goBack/only Android)
goBack
返回上一页,仅支持 Android
端
- goBack