元素定位方式

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

  1. - 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 向指定坐标滑动,参数为坐标&持续时间fromxfromytoxtoyduring ,默认:2 ,也可以指定具体方向updownleftright

- 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 打开应用,默认参数为configactivity ,暂时支持 Android

- launchApp('com.taobao.taobao/com.taobao.tao.TBMainActivity')

关闭应用(closeApp/only Android)

closeApp 关闭应用,默认参数为configpackage , 暂时支持 Android

- closeApp('com.taobao.taobao')

adb(adb/only Android)

adb 命令,仅支持 Android

- adb('input text hello')

返回(goBack/only Android)

goBack 返回上一页,仅支持 Android

- goBack