Android UiAutomator UiObject API

UiObject类

一、点击与长按

代码示例：

    /*点击与长按*/
    public void testClick() throws UiObjectNotFoundException {
        UiObject clock = new UiObject(new UiSelector().text("Clock"));
// clock.click();
// clock.clickAndWaitForNewWindow(5000);
        clock.clickTopLeft();
        UiDevice.getInstance().pressBack();
        clock.longClick();
        UiDevice.getInstance().pressBack();
        //长按也可以通过swipe实现
        UiDevice.getInstance().swipe(360, 433, 364, 434, 300);
    }

    /*拖拽与滑动*/
    public void testDrag() throws UiObjectNotFoundException {
        UiObject contact = new UiObject(new UiSelector().className("android.widget.TextView").index(2));
        contact.swipeUp(30);
    }

二、拖拽与滑动

拖拽

dragTo (UiObject destObj, int steps)：拖拽对象到另一个对象位置上面，可以设置拖动的速度，默认40 steps
dragTo (int destX, int destY, int steps)：拖拽对象到某个坐标位置，步长可以设置，默认40 steps

滑动

swipeDown (int steps)：拖动对象向下滑动，步长可以设置
swipeLeft (int steps)：拖动对象向左滑动，步长可以设置
swipeRight (int steps)：拖动对象向右滑动，步长可以设置
swipeUp (int steps)：拖动对象向上滑动，步长可以设置

输入/清除文本

setText (String text)：设置文本框对象的文本内容

clearTextField ()：清除文本框对象的文本内容

获取对象属性

getBounds ()：获取对象的矩形坐标，即矩形左上角和右下角坐标

getChild (UiSelector selector)：获取对象的子对象，可以根据子对象的特殊属性来获取

getChildCount ()：获取下一级子类的数量

getClassName ()：获取对象的类名

getContentDescription ()：获取对象的文本描述

getFromParent (UiSelector selector)：从父类获取子类，根据子类的特殊属性来获取

getPackageName ()：获取对象的包名

UiSelector getSelector ()：获取selector，用于调试，实用性不大

getText ()：获取对象的文本信息

getVisibleBounds ()：返回可见视图的范围

属性判断

isCheckable ()：检查对象的Check属性是否为true，判断当前对象是否可以打钩

isChecked ()：检查对象的Checked属性是否为true，判断当前对象是否已经打钩

isClickable ()：检查对象的Click属性是否为true，判断当前对象是否可以点击

isEnabled ()：检查对象的Enable属性是否为true，判断当前对象是否可用

isFocusable ()：检查对象的Focusable属性是否为true，判断当前对象是都可以获取焦点

isFocused ()：检查对象的Focus属性是否为true，判断当前对象是否已经获取焦点

isLongClickable ()：检查对象的LongClick属性是否为true，判断当前对象是都可以长按

isScrollable ()：检查对象的LongClick属性是否为true，判断当前对象是都可以滑动

isSelected ()：检查对象的Selected属性是否为true，判断当前对象是都已经选中

手势操作

performMultiPointerGesture (PointerCoords… touches)：执行单手指触控手势，可定义任何手势和形状

performTwoPointerGesture (Point startPoint1, Point startPoint2, Point endPoint1, Point endPoint2, int steps)：执行任意两个手指触控，模拟两个手指手势

pinchIn (int percent, int steps)：手指操作，两点向内收缩

pinchOut (int percent, int steps)：手指操作，两点向外扩展

对象是否存在

waitForExists (long timeout)：等待对象出现， 可设置时长

waitUntilGone (long timeout)：等待对象消失， 可设置时长

exists ()：判断对象是否存在