Android自动化测试Uiautomator--UiObject接口简介

UiObject可以理解为控件的对象，主要对对象进行操作。按照一定条件(UiSelector)获取UiObject对象，之后对对象进行相应的操作，如下图所示。

对于对象的操作主要有点击/长按、拖动/滑动、文本输入与清除、属性、对象是否存在、手势操作等。

点击与长按方面的方法：

　　举例：UiObject ok = new UiObject(new UiSelector().text("OK"));//声明对象

　　　　　ok.click();//点击"OK" text.

　　1.public boolean click() 点击对象

　　2.public boolean clickAndWaitForNewWindow(long timeout) 点击对象，等待新窗口出现，参数为等待超时时长

　　3.public boolean clickAndWaitForNewWindows() 点击对象，等待新窗口出现

　　4.public boolean clickBottomRight() 点击对象的右下角

　　5.public boolean clickTopLeft() 点击对象的左上角

　　6.public boolean longClick() 长按对象

　　7.public boolean longClickBottomRight() 长按对象的右下角

　　8.public bolean longClickTopLeft() 长按对象的左上角

拖拽与滑动方面的方法：

　　举例：UiObject answerCall = new UiObject(new UiSelector().textStartWith("右滑接听"))；

　　　　　 answerCall.swipeRight(10);

　　1.public boolean dragTo(UiObject destObj, int steps)

　　　　拖拽对象到另一个对象上，步长可设置拖动的速度，步长越小，拖动速度越快。

　　2.public boolean dragTo(int deskX, int deskY, int steps)

　　　　拖拽对象到屏幕某个坐标位置上，步长可设置拖动速度

　　3.public boolean swipeDown(int steps)

　　　　拖动对象往下滑

　　4.public boolean swipeLeft(int steps)

　　　　拖动对象往左滑

　　5.public boolean swipeRight(int steps)

　　　　拖动对象往右滑

　　6.public boolean swipeUp(int steps)

　　　　拖动对象往上滑

输入文本与清除文本方面的操作：

　　举例：UiObject inputMessage = new UiObject(new UiSeletor().text("Please inout message content"));

　　　　　inputMessage.setText("Message Test") //在短信编辑框中输入文本内容

　　　　　UiObject clearMessage = new UiObject(new UiSelector().text("Message Test"));

　　　　　clearMessage.clearTextField(); //输入完后清除短信编辑框文本内容

　　1.public boolean setText(String text) 在对象中输入文本

　　2.public boolean clearTextField() 清除编辑框文本

获取对象属性方面的方法：

　　举例：UiObject getTextObject = new UiObject(new UiSelector().className(android.widget.TextView)) //获取第一个textView

　　　　　String textrString = getTextObject.getText(); //获得textView的文本

　　1. public rect getBounds()

　　　　获取对象矩形坐标，矩形坐标左上角与右下角坐标。

　　2.public UiObject getChild(UiSelector selector)

　　　　获取对象的子类对象，可以递归获取子孙当中的某个对象

　　3.public int getChildCount()

　　　　获得下一级子类的数量

　　4.public String getClassName()

　　　　获得对象类名属性的类名文本

　　5.public String getContentDescription()

　　　　获得对象的描述属性的描述文本

　　6.public UiObject getFromParent(UiSelector selector)

　　　　从父类获取子类，按照uiselector获取兄弟类

　　7. public String getPackageName()

　　　　获取对象包名属性的包名文件

　　8.public final UiSelector getSelector()

　　　　获取selector用于调试

　　9.public String getText()

　　　　获取对象的文本属性中的文本

属性判断方面的方法：

　　举例：UiObject inpputTextObject = new UiObject(new UiSelector().className("android.widget.Switch")); //声明开关对象

　　if(inputTextObject.isChecked())

　　{

　　　　inputTextObject.click(); //如果开关是开，则点击关闭。

　　}

　　1.public boolean isCheckable() 检查对象的checkable属性是否为true

　　2.public boolean isChecked() 检查对象的checked属性是否为true

　　3.public boolean isClickable() 检查对象的clickable属性是否为true

　　4.public boolean isEnabled() 检查对象的enable属性是否为true

　　5.public boolean isFocusable() 检查对象的focusable属性是否为true

　　6.public boolean isLongClickable() 检查对象的longClickable属性是否为true

　　7.public boolean isScrollable() 检查对象的scrollable属性是否为true

　　8.public boolean isSelected() 检查对象的selected属性是否为true

手势操作方面的方法：

　　举例：

　　UiObject framObject = new UiObject(new UiSelector().className("android.widget.FrameLayout"));

　　PointerCoords p = new PointerCoords();

　　p.x = 500;

　　p.y= 500;

　　p.pressure = 1;

　　p.size = 1;

　　PointerCoords p1 = new PointerCoords();

　　p1.x = 600;

　　p1.y= 600;

　　p1.pressure = 1;

　　p1.size = 1;

　　PointerCoords p2 = new PointerCoords();

　　p2.x = 500;

　　p2.y=500;

　　p2.pressure = 1;

　　p2.size = 1;

　　frameObject.performMultiPointerGesture(p,p1,p2);

　　1.public boolean performTwoPointerGesture(Point staretPoint1, Point statsPoint2, Point endPoint1, Point endPoint2, int steps)

　　　　执行任意两个手指触控手势，模拟两个手指手势

　　2.public boolean pinchIn(int precent, int steps)

　　　　手势操作，两点向内收缩

　　3.public boolean pinchOut(int percent, int steps)

　　　　手势操作，两点向外张开

　　4.public boolean performMultiPointerGesture(PointerCoords... touches)

　　　　执行单手指触手势，可定义任意手势与形状

　　

判断对象是否存在、是否出现与是否消失方面的方法：

　　举例：

　　Runtime.getRuntime().exec(am start -n com.android.calculator2/com.android.calculator2.Calculator); // 打开计算机

　　UiObject addObject = new UiObject(new UiSelector().text("+)); //计算机界面"+"对象

　　addObject.waitForExists(10000);

总结：

　　1.声明UiOject对象后，不管对象存不存在都不会有问题---先声明对象，后操作；

　　2.当对象可能出现可能不出现的时候，需要对对象进行判断；

此博客参考文档：

http://wenku.baidu.com/view/4e242fb9680203d8ce2f24f6.html?re=view

　　1.public boolean waitForExist(long timeout) 等待对象出现

　　2.public boolean waitUntilGone(long timeout) 等待对象消失

　　3.public boolean exists() 检查对象是否存在