UIAutomator1.0 API简介

1. UiDevice对象
getUiDevice()的方法可以得到一个UiDevice的对象,通过这个对象可以完成一些针对设备的动作:
click(int x, int y)
----在(x,y)表示的像素地方点击
pressBack()
pressDelete()
pressEnter()
pressHome()
pressMenu()
pressSearch()
----点击相应的按键
wakeUp()
----当手机处于灭屏状态时,唤醒屏幕,并解锁。
swipe(startX, startY, endX, endY, steps)
----在手机上滑动,从(startX,startY)到(endX,endY)。steps表示滑动的这个距离分为几步完成,数目越少,滑动幅度越大。
setOrientationLeft()
setOrientationRight()
----将手机向相应方向旋转。
setOrientationNatural()
----将手机旋转状态回归正常。

2. UiSelector对象
UiSelector可以理解为一种条件对象,描述的是一种条件,配合UiObject使用,可以得到某个(某些)符合条件的控件对象。
checked(boolean val)
----描述一种check状态为val的关系。
className(className)
----描述一种类名为className的对象关系
clickable(boolean val)
----与checked类似,描述clickable状态为val的关系
description(desc)
----描述信息
descriptionContains(desc)
----与description类似
focusable(boolean val)
----与checked类似
index(index)
----用当前对象在父对象集中的索引作为描述
packageName(String name)
----用包名作为条件描述
selected(val)
----描述一种选择关系
text(text)
----最为常用的一种关系,用控件上的文本即可找到当前控件,需要注意,所有使用text属性找到的控件。
textContains(text)
----与text类似
textStartsWith(text)
----与text类似

3. UiObject对象
控件对象,一个UiObject对象可以通过一下形式得到:
UiObject mItem = new UiObject(new UiSelector().text("English"));
也就是配合一个UiSelector就可以得到一个控件。
click()
----点击控件
clickAndWaitForNewWindow()
----点击某个控件,并等待窗口刷新
longClick()
----长按
clearTextField()
----清除文本,主要针对编辑框
getChildCount()
----这个方法可以看出,其实UiObject也可以是一个控件的集合
getPackageName()
----得到控件的包名
getSelector()
----得到当前控件的选择条件
getText()
----得到控件上的Text
isCheckable()
isChecked()
isClickable()
isLongClickable()
isScrollable()
isScrollable()
isSelected()
----判断是否具备某个属性

4. UiCollection对象
这个对象可以理解为一个对象的集合。因为UiSelector描述后得到的有可能是多个满足条件的控件集合,因此可以用来生成UiCollection:
UiCollection mUiCollection = new UiCollection(new UiSelector().text("Settings"));
getChild(selector)
----从集合中再次通过UiSelector选择一个UiObject对象
getChildByDescription(childPattern, text)
----从一个匹配模式中再次以text为条件选择UiObject
getChildByText(childPattern, text)
----与上面类似。
getChildCount()
----得到当前集合中控件的个数

5. UiScrollable对象
UiScrollable可以生成一个滚动动作的对象,其最大的作用就是可以实现滚动的查找某个元素。比如在“设置”菜单中,“语言和输入法”这个菜单比较靠下,需要滚动后才可以看到(找到),因此就用上了UiScrollable:
UiScrollable settingItems = new UiScrollable( new UiSelector().scrollable(true)); 
UiObject languageAndInputItem = settingItems.getChildByText(new UiSelector().text("Language & input"), "Language & input", true); 
上面的形式就可以在滚动中查找显示有“Language & input”的控件,也就是“语言和输入法”的设置项。

6. sleep和添加Log的方法
如果是对于一个标准的UiObject对象,可以通过clickAndWaitForNewWindow的方法在点击之后主动等待一段事件,但是如果需要额外的等待一段时间,特别对于getUiDevice().pressHome();这种操作,可能需要很长的事件去为下一步操作获取更多的事件,此时我们可以使用线程的sleep方法去实现:
//等待3秒 
try { 
Thread.sleep(3000); 
} catch (InterruptedException e1) { 
e1.printStackTrace(); 

而添加Log的方法也可以通过Java标准的println来实现:
System.out.println("This used to print some log!!!" + setLanItem.getText());
以上Log将会在jar被运行时通过cmd窗口打印出来。




 

你可能感兴趣的:(UiAutomator1.0)