元素定位方式
框架支持name、id、xpath、classname4种方式获取元素,我们做了一定简化…. 另外,我们新加入了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
