Android Instrumentation基础使用

    这两天准备研究Robotium的源码，不过由于Robotium是以Instrumentation为基础的，因此就先补习了一下Instrumentation的基础。

    Instrumentation是Android自带一个单元测试框架，不过虽然这么说，其对于大部分应用开发人员来讲，最大的作用反而是用于功能或UI测试。

 

    整个框架继承自JUnit框架，使用方法也类似，也是要继承TestCase类。不过在Instrumentation中，需要继承的是几个Google提供的TestCase的子类，其中最重要也是最常用的是ActivityInstrumentationTestCase2这个类，一般进行应用界面测试时都需继承此类（Robotium一般也是使用此类）。当然，Android也提供了几个其他选择用于测试其他组件：

 

• ActivityUnitTestCase: 用于单独Activity的单元测试
• ApplicationTestCase：用于测试Application
• ProviderTestCase2：用于测试Provider的测试类
• ServiceTestCase：用于测试service的测试类

 

    这几个类全部基于AndroidTestCase类，只不过根据各个组件的特性提供了不同的get方法，如getActivity(), getService()等等，而AndroidTestCase继承于junit的TestCase类，所以所有测试类遵循单元测试框架。

 

    要写一个APK的Instrumentation测试，首先准备一个测试目标——即待测试的APK。然后再建立一个APK作为测试APK，在Manifest中添加如下声明(其中targetPackage一项需要填写测试目标的包名)：

    <instrumentation
        android:name="android.test.InstrumentationTestRunner"
        android:targetPackage="com.test.target" />

 

    同时，还需在Application标签中嵌入如下声明:

<uses-library android:name="android.test.runner" />

     

    声明完毕，可以开始写测试代码了，如下：

 

package com.tc.upnptest.test;

import android.app.Activity;
import android.app.Instrumentation.ActivityMonitor;
import android.app.Instrumentation.ActivityResult;
import android.content.Intent;
import android.os.SystemClock;
import android.test.ActivityInstrumentationTestCase2;
import android.util.Log;
import android.widget.Button;
import android.widget.TextView;

public class MainTest extends ActivityInstrumentationTestCase2{
        private Activity target;
        private TextView tx;

	public MainTest() throws ClassNotFoundException {
		super(Class.forName("com.test.target.MainActivity"));
	}
	
	@Override
	protected void setUp() throws Exception {
		super.setUp();
                target =  getActivity();
                tx = (TextView) a.findViewById(0x7f060000);
	}

	@Override
	protected void tearDown() throws Exception {
		super.tearDown();
	}
	
	public void testMain() {
		dosomething();
                assertTrue(true);
	}
}

   

    首先写一个类继承ActivityInstrumentationTestCase2，如上面的MainTest。需要注意的是此类的构造方法不要加任何参数，在构造方法中直接调用super(Class)即可，其中Class就是要测的Activity的Class。

 

    getActivity()会自动获取Activity对象（就是上面声明的Class对应的Activity），如果Activity没有启动则会自动启动。如果想要主动启动Activity，可以用launchActivityWithIntent，或instrumentation.startActivitySync。

 

    另外，在setUp中调用setActivityInitialTouchMode可以让测试目标处于非触摸模式，以防止测试途中误操作。

    写完了测试类，即可开始运行。在eclipse中右击项目，在弹出的菜单中选择Run as → Android JUnit Test运行，即可看到如下界面：

     

    下面的是一些测试中的常用界面操控方法，方法中需要获取instrumentation对象，直接在类中调用getInstrumentation()即可，下面不再赘述。

 

1. 可以直接获取Activity对象，通过findViewById来获取各个View控件，已完成对于各个View的操作，id值可以通过目标APK的R文件获取。
2. 测试类仍需遵循Android的基本原则，对于View的更改必须要在UI线程中执行，因此要对View进行直接操作，需要利用runTestOnUiThread(Runnable r)函数。
3. 需要对界面直接进行点击、滑动、按键等操作，可以用sendKeys发送一些按键，也可以直接用instrumentation类中的sendKeyDownUpSync, sendKeySync, sendPointerSync等方法发送原始的事件。

   

    当测试时有Activity跳转时，可以用ActivityMonitor捕获新的Activity，如下操作：

		ActivityMonitor am = new ActivityMonitor("com.test.target.Activity2", null, false);
		getInstrumentation().addMonitor(am);
		Activity b = getInstrumentation().waitForMonitor(am);

 

    测试时往往需要等待一个UI事件执行完毕，再进行下一个测试操作，这时可以直接调用

 

		getInstrumentation().waitForIdleSync();