Android单元测试初探——Instrumentation

         这是我以前在和讯博客上写的一篇文章，现在就把它转发到这里来，原文地址：

       和讯博客：http://14957395.blog.hexun.com/57120862_a.html

       华中科技大学OPhone俱乐部：http://www.dian.org.cn/ophone/?p=162

       首先，我们来了解一下android的测试类的层次结构：

 

      可以看出android中的测试方法主要AndroidTextCase和InstrumentationTextCase.在这篇文章中，我将介绍Instrumentation这种测试方法,那么什么是Instrumentation？

 Instrumentation和Activity有点类似，只不过Activity是需要一个界面的，而Instrumentation并不是这样的，我们可以将它理解为一种没有图形界面的，具有启动能力的，用于监控其他类(用Target Package声明)的工具类。

 下面通过一个简单的例子来讲解Instrumentation的基本测试方法。

    1.首先建立一个android  project,类名为Sample,代码如下：

package com.hustophone.sample;
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.TextView; 

public class Sample extends Activity {

    private TextView myText = null;
    private Button button = null; 

    /** Called when the activity is first created. */

    @Override

    public void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.main);

        myText = (TextView) findViewById(R.id.text1);

        button = (Button) findViewById(R.id.button1);

        button.setOnClickListener(new OnClickListener() {
 

            @Override

            public void onClick(View arg0) {

                // TODO Auto-generated method stub

                myText.setText("Hello Android");

            }

        });

    } 

    public int add(int i, int j) {

        // TODO Auto-generated method stub

        return (i + j);

    }

}

       这个程序的功能比较简单，点击按钮之后，TextView的内容由Hello变为Hello Android.同时，在这个类中，我还写了一个简单的方法，没有被调用，仅供测试而已。

   2. 在src文件夹中添加一个测试包，在测试包中添加一个测试类SampleTest

    测试类的代码如下：

package com.hustophone.sample.test;
import com.hustophone.sample.R;
import com.hustophone.sample.Sample;
import android.content.Intent;
import android.os.SystemClock;
import android.test.InstrumentationTestCase;
import android.util.Log;
import android.widget.Button;
import android.widget.TextView; 

public class SampleTest extends InstrumentationTestCase {

    private Sample sample = null;
    private Button button = null;
    private TextView text = null;

    /*

     * 初始设置
     *
     * @see junit.framework.TestCase#setUp()
     */

    @Override

    protected void setUp()  {

        try {
            super.setUp();
        } catch (Exception e) {

            // TODO Auto-generated catch block
            e.printStackTrace();
        }

        Intent intent = new Intent();
        intent.setClassName("com.hustophone.sample", Sample.class.getName());
        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        sample = (Sample) getInstrumentation().startActivitySync(intent);
        text = (TextView) sample.findViewById(R.id.text1);
        button = (Button) sample.findViewById(R.id.button1);

    }

    /*

     * 垃圾清理与资源回收

     *
     * @see android.test.InstrumentationTestCase#tearDown()

     */

    @Override

    protected void tearDown()  {

        sample.finish();

        try {

            super.tearDown();

        } catch (Exception e) {

            // TODO Auto-generated catch block

            e.printStackTrace();

        }

    }

 

    /*

     * 活动功能测试

     */

public void testActivity() throws Exception {

Log.v("testActivity", "test the Activity");

        SystemClock.sleep(1500);

        getInstrumentation().runOnMainSync(new PerformClick(button));

        SystemClock.sleep(3000);

        assertEquals("Hello Android", text.getText().toString());

    } 

    /*

     * 模拟按钮点击的接口

     */

    private class PerformClick implements Runnable {

        Button btn; 

        public PerformClick(Button button) {

            btn = button;

        } 

        public void run() {

            btn.performClick();

        }

    } 

    /*

     * 测试类中的方法

     */

    public void testAdd() throws Exception{

        String tag = "testAdd";

        Log.v(tag, "test the method");

        int test = sample.add(1, 1);

        assertEquals(2, test);

    } 

}

   下面来简单讲解一下代码：

  setUp()和tearDown()都是受保护的方法，通过继承可以覆写这些方法。

  在android Developer中有如下的解释

protected void setUp ()

Since: API Level 3

Sets up the fixture, for example, open a network connection. This method is called before a test is executed.

protected void tearDown ()

Since: API Level 3

Make sure all resources are cleaned up and garbage collected before moving on to the next test. Subclasses that override this method should make sure they call super.tearDown() at the end of the overriding method. 

    setUp ()用来初始设置，如启动一个Activity,初始化资源等。

    tearDown ()则用来垃圾清理与资源回收。

 在testActivity()这个测试方法中，我模拟了一个按钮点击事件，然后来判断程序是否按照预期的执行。在这里PerformClick这个方法继承了Runnable接口，通过新的线程来执行模拟事件，之所以这么做，是因为如果直接在UI线程中运行可能会阻滞UI线程。 

   3.要想正确地执行测试，还需要修改AndroidManifest.xml这个文件.

 

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
	package="com.hustophone.sample" android:versionCode="1"
	android:versionName="1.0">
	<application android:icon="@drawable/icon" android:label="@string/app_name">
		<!--用于引入测试库-->
		<uses-library android:name="android.test.runner" />
		<activity android:name=".Sample" android:label="@string/app_name">
			<intent-filter>
				<action android:name="android.intent.action.MAIN" />
				<category android:name="android.intent.category.LAUNCHER" />
			</intent-filter>
		</activity>
	</application>
	<uses-sdk android:minSdkVersion="3" />
	<!--表示被测试的目标包与instrumentation的名称。-->
	<instrumentation android:targetPackage="com.hustophone.sample"
		android:name="android.test.InstrumentationTestRunner" />
</manifest>

 

     注意：以上xml代码中的<span></span>是粘贴后发表产生的，我试了几次，都删不掉，有哪位大侠知道的话可以指点指点。

     其中红色标记部分是添加的。

<uses-library android:name="android.test.runner" />用于引入测试库

<instrumentation android:targetPackage="com.hustophone.sample"

       android:name="android.test.InstrumentationTestRunner" />

   表示被测试的目标包与instrumentation的名称。 

   经过以上步骤，下面可以开始测试了。测试方法也有以下几种，下面介绍两个常用的方法：

 (1) 用Eclipse集成的JUnit工具

     在Eclipse中选择工程Sample，单击右键，在Run as子菜单选项中选择Android JUnit Test

     同时可以通过LogCat工具查看信息

 (2) 通过模拟器运行单元测试

     点击模拟器界面的Dev Tools菜单

      再点击Instrumentation选项，进入Instrumentation菜单

    这里有一个InstrumentationTestRunner,它是测试的入口，点击这个选项，就可以自动运行我们的测试代码。以下为运行结果：

按钮点击前

按钮点击后

至此，一个简单的测试过程结束了。当然，android的测试内容还有很多，也有比较复杂的，我会在以后的学习过程中继续分享我的体会。好了，今天就到这里吧！

 

 

 

 

评论

1 楼 George_ghc 2012-02-08  

不错！现在正在学习instrumentation类！