[UiAutomator] UiSelector中使用instance与index方法定位控件的区别

在使用UiAutomator写测试用例时，最常用到的就是控件查找操作。

在UiSelector中，有两个定位控件的方法，一个是instance，一个是index。那么这两个方法有什么区别呢？

首先，我们看一下官方api说明：

instance(int instance):
Set the search criteria to match the widget by its instance number. The instance value must be 0 or greater, where the first instance is 0. For example, to simulate a user click on the third image that is enabled in a UI screen, you could specify a a search criteria where the instance is 2, the className(String) matches the image widget class, and enabled(boolean) is true. The code would look like this: new UiSelector().className("android.widget.ImageView") .enabled(true).instance(2);

index(int index):
Set the search criteria to match the widget by its node index in the layout hierarchy. The index value must be 0 or greater. Using the index can be unreliable and should only be used as a last resort for matching. Instead, consider using the instance(int) method.

也就是说instance方法会将界面上所有相同类型的控件按顺序取出来，放到一个集合里（暂且这么理解吧，不知道放哪里了，囧），然后按照控件在集合的角标把想要的控件取出来；而index则是通过该控件所在层级的节点角标将对应的控件取出来。

那么这两个方法到底是怎么使用的呢？看下面的例子：

首先我们通过xml定义一个布局:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=".MainActivity" >

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center_horizontal"
        android:text="textview1"
        android:textSize="22sp" />

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="button1" />

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center_horizontal"
        android:text="textview2"
        android:textSize="22sp" />

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="button2" />

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center_horizontal"
        android:text="textview3"
        android:textSize="22sp" />

</LinearLayout>

使用UiAutomatorViewer截出来的图是这样的：

按照说明，使用index方法获取TextView控件是这样的：

UiObject obj = new UiObject(new UiSelector().className("android.widget.TextView").index(0)); // textview1
UiObject obj = new UiObject(new UiSelector().className("android.widget.TextView").index(2));  // textview2
UiObject obj = new UiObject(new UiSelector().className("android.widget.TextView").index(4));  // textview3

哎，等等，尼玛！为啥我第一个方法取到的UiObject是“TestUI”？原来在我们的TitleBar上也有一个TextView控件，而它的节点角标也是0（见下图）。这是不是太坑爹了？先不要埋怨，人家api文档都说的很清楚了，这是一个不靠谱（unreliable）的方法,其他方法都不好使了才建议去尝试此方法。

下面把使用instance方法获取TextView控件的方法写出来：

UiObject obj = new UiObject(new UiSelector().className("android.widget.TextView").instance(0)); // TestUI

UiObject obj = new UiObject(new UiSelector().className("android.widget.TextView").instance(1)); // textview1
UiObject obj = new UiObject(new UiSelector().className("android.widget.TextView").instance(2));  // textview2
UiObject obj = new UiObject(new UiSelector().className("android.widget.TextView").instance(3));  // textview3

怎么样，使用instance方法就靠谱多了吧。

本次分享到此结束，欢迎大家与我一起交流。

============================2014-12-25 分割线===================

今天上网看博客，发现index方法还有一种用法，就是在UiObject.getChild()方法里使用。还是以上面的UI为例。

如果我们想要获取textview1对应的TextView控件，首先找到它的父控件LinearLayout，而LinearLayout又是FrameLayout的子控件（如下图）。

所以，获取textview1的代码大概是这样：

UiObject viewObj = new UiObject(new UiSelector().className("android.view.View")); // 获取View控件
UiObject flObj = viewObj.getChild(new UiSelector().index(1)); // 获取FrameLayout控件
UiObject llObj = flObj.getChild(new UiSelector().index(0)); // 获取LinearLayout控件
UiObject tv1Obj = llObj.getChild(new UiSelector().index(0)); // 获取textview1对应的TextView控件

 

怎么样？还是instance好用吧！