Android 自己的自动化测试（4）<uiautomator>

在前面的系列文章。我与介绍java实现 Android
自己主动化測试（1）怎样安装和卸载一个应用(java)、Android
自己主动化測试（2）依据ID查找对象(java)；然后又介绍了用python语言来实现Android 自己主动化測试（3） 依据ID查找对象&touch&type
(python)。

还说过兴许要写点关于UI測试和代码覆盖測试的文章。今天要介绍的就是UI測试。

1、 概要

做过java单元測试的同学。使用Android的单元測试比較简单，參见 怎样进行Android单元測试，採用这样的方式。业务逻辑上的測试就攻克了。

仅仅是有一个明显的缺陷就是測试界面不方便。

而对于android应用程序来说。界面占领了非常重要的一个部分。

这个时候能够使用uiautomator.jar这个类库。  这里我不详细讲详细的Android 的 uiautomator类库怎么使用。

详细的使用能够參见Android
UI Testing （英文版）， 和 Android
uiautomator 使用入门官方教程(中文版)。

2、核心类

我主要提一下里面最重要的核心类UiDevice、UISelector和UiObject ，怎样查找对象和作用于对象是測试的核心。

UiDevice

Represents the device state. In your tests, you can call methods on the  UiDevice  instance to check for the state of various properties, such as current
orientation or display size. Your tests also can use the  UiDevice  instance to perform device level actions, such as forcing the device into a specific rotation, pressing the d-pad hardware button, or pressing the Home and Menu buttons.

      UiDevice代表设备状态。在測试时，能够调用UiDevice实例的方法来检查不同属性的状态。如当前的屏幕旋转方向货展示大小。

測试代码还能使用UiDevice实例来运行设备级的操作。如强制设备横竖屏。按压d-pad硬件button。或按压主屏幕键和菜单键。

      获取UiDevice实例，模拟按压主屏幕键的代码例如以下： getUiDevice (). pressHome ();

UiSelector 

      Represents a search criteria to query and get a handle on specific elements in the currently displayed UI. If more than one matching element is found, the first matching element in the layout hierarchy is returned as the target UiObject. When constructing
a  UiSelector , you can chain together multiple properties to refine your search. If no matching UI element is found, a UiAutomatorObjectNotFoundException  is thrown. You can use the  childSelector()  method to nest multiple  UiSelector  instances. For example,
the following code example shows how to specify a search to find the first  ListView  in the currently displayed UI, then search within that  ListView  to find a UI element with the text property Apps. 

      UiSelector代表一种搜索标准，能够在当前展示界面上查询和获取特定元素的句柄。若找到多于一个的匹配元素，则返回布局层次结构上的第一个匹配元素作为目标UiObject。当构造一个UiSelector对象时，能够使用链式调用多个属性来缩小查询范围。

如无匹配元素，则返回异常 UiAutomatorObjectNotFoundException 。

你还能够使用 childSelector()  方法来嵌套多个Uiselector实例。比如。以下的代码演示怎样制定查询来定位在当前界面的第一个ListView，然后在返回的ListView内定位一个带有Apps文本属性的界面元素。

UiObject  appItem  =   new   UiObject ( new   UiSelector () . className ( “android.widget.ListView” ). instance ( 1 ) . childSelector ( new   UiSelector (). text ( “Apps” )));

  UiObject 

      Represents a UI element. To create a  UiObject  instance, use a UiSelector that describes how to search for, or select, the UI element.

The following code example shows how to construct  UiObject  instances that represent a Cancel button and a OKbutton in your application.

UiObject代表一个UI元素。为创建一个UiObject实例，使用用来描写叙述怎样搜索、选定UI元素的UiSelector实例：

UiObject  cancelButton  =   new   UiObject ( new   UiSelector (). text ( “Cancel” ));
UiObject  okButton  =   new   UiObject ( new   UiSelector (). text ( “OK” ));

You can reuse the  UiObject  instances that you have created in other parts of your app testing, as needed. Note that the uiautomator test framework searches
the current display for a match every time your test uses a  UiObject instance to click on a UI element or query a property.

      In the following code example, the uiautomator test framework searches for a UI element with the text property OK. If a match is found and if the element is enabled, the framework simulates a user click action on the element.You can also restrict the
search to find only elements of a specific class. For example, to find matches of the  Button class:

      必要时，能够重用測试项目中已经创建的UiObject实例。

注意，測试用例每次使用UiObject实例来点击UI元素或查询属性时。uiautomator測试框架会搜索当前的界面来寻找匹配。

在以下的代码中。uiautomator測试框架搜索带有OK文本属性的UI元素。

若发现匹配，而且该元素启用。框架会模拟用户的在该元素上的点击操作。

if ( okButton . exists ()   &&  okButton . isEnabled ()) {
    okButton . click ();
}

还能够限制搜索在几个特定的类中寻找元素，比如，为发现Button类的匹配：

UiObject  cancelButton  =   new   UiObject ( new   UiSelector (). text ( “Cancel” ) .className ( “android.widget.Button” ));
UiObject  okButton  =   new   UiObject ( new   UiSelector (). text ( “OK” ) .className ( “android.widget.Button” ));

3、 具体例子。注意类库中须要引用android.jar和uiautomator.jar包啊

package xzy.test.uiautomator;

import java.io.IOException;

import android.os.RemoteException;

import com.android.uiautomator.core.UiDevice;
import com.android.uiautomator.core.UiObject;
import com.android.uiautomator.core.UiObjectNotFoundException;
import com.android.uiautomator.core.UiSelector;
import com.android.uiautomator.testrunner.UiAutomatorTestCase;

public class CalTest extends UiAutomatorTestCase {

	public void testDemo() throws UiObjectNotFoundException, RemoteException {

		UiDevice device = getUiDevice();
		// 唤醒屏幕
		device.wakeUp();
		assertTrue("screenOn: can't wakeup", device.isScreenOn());
		// 回到HOME
		device.pressHome();
		sleep(1000);

		// 启动计算器App
		try {
			Runtime.getRuntime().exec(
					"am start -n com.android.calculator2/.Calculator");
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}

		sleep(1000);
		UiObject oneButton = new UiObject(new UiSelector().text("1"));
		assertTrue("oneButton not found", oneButton.exists());
		UiObject plusButton = new UiObject(new UiSelector().text("+"));
		assertTrue("plusButton not found", plusButton.exists());

		sleep(100);

		UiObject equalButton = new UiObject(new UiSelector().text("="));
		assertTrue("equalButton not found", equalButton.exists());

		oneButton.click();
		sleep(100);
		plusButton.click();
		sleep(100);
		oneButton.click();

		equalButton.click();
		sleep(100);

		UiObject switcher = new UiObject(
				new UiSelector()
						.resourceId("com.android.calculator2:id/display"));
		UiObject result = switcher.getChild(new UiSelector().index(0));
		System.out.print("text is :" + result.getText());
		assertTrue("result != 2", result.getText().equals("2"));
	}
}

4、总结一下

单元測试比較简单，可是非常有效,对于要做自己主动化測试的团队，和要提供稳定而又质量的交付。单元測试是非常重要的噢 。Android已经有一套非常完好的单元測试支持了。UI測试也 OK

5、后面会介绍一些採用 robotium 框架进行Android UI Test &
Android Code Coverage Test

版权声明：本文博主原创文章。博客，未经同意不得转载。