如何在Android的单元测试中做标记?
在android.test.annotation包里定义了几个annotation,包括@LargeTest,@MediumTest,@SmallTest,@Smoke,和@Suppress。你可以根据自己的需要用这些annotation来对自己的测试分类。在执行单元测试命令时,可以在-e参数后设置“size large”/ “size medium”/ “size small”来执行具有相应标记的测试。特别的@Supperss可以取消被标记的Test的执行。
完整的操作过程
总结以上所有的内容,编写并运行完整的测试需要以下的步骤:
以上步骤中,在Android自带的例子中,我发现它有两个manifest.xml。也就是说在步骤3中源代码和测试代码分别生成了两个不同的包。然后步骤4利用adb install命令安装到了虚拟机上。由于我没有找到Eclipse ADT有办法可以为一个只有Instrumentation,没有Activity的Application打包并安装,于是采用了略微不同的办法完成了这个工作。下面将一一详细介绍整个过程。
1. 编写程序
我新建了一个项目TestApp,参数为:
Package Name:com.android.testapp
Activity Name:MainActivity
Application Name:TestApp
以下是MainActivity的源代码:
package com.android.testapp; import android.app.Activity; import android.os.Bundle; public class MainActivity extends Activity { /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); } public int sum(int a, int b) { return a + b; } public int substract(int a, int b) { return b - a; } } |
其中,我故意将减法的a – b写成了b – a。
2. 编写测试程序
然后,我新建了一个Source Folder,名为test,并在里面新建了包com.android.testapp.test。并定义了一个TestCase,名为TestMainActivity,源代码如下:
package com.android.testapp.test; import com.android.testapp.MainActivity; import android.test.ActivityInstrumentationTestCase; import android.test.suitebuilder.annotation.MediumTest; public class TestMainActivity extends ActivityInstrumentationTestCase<MainActivity> { public TestMainActivity() { super("com.android.testapp", MainActivity.class); } public TestMainActivity(String pkg, Class<MainActivity> activityClass) { super(pkg, activityClass); } @MediumTest public void testSum() { assertEquals(3, getActivity().sum(1, 2)); } @MediumTest public void testSubstract() { assertEquals(-1, getActivity().substract(1, 2)); } } |
我继承了ActivityInstrumentationTestCase。这个TestCase在执行时会自动帮我启动相应的Activity。
接下来就是程序的Manifest:
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android=" http://schemas.android.com/apk/res/android" package="com.android.testapp" android:versionCode="1" android:versionName="1.0.0"> <application android:icon="@drawable/icon" android:label="@string/app_name"> <activity android:name=".MainActivity" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <uses-library android:name="android.test.runner" /> </application> <instrumentation android:targetPackage="com.android.testapp" android:name="android.test.InstrumentationTestRunner" android:label="Test Unit Tests"></instrumentation> </manifest> |
在这个文件中,我将Activity和Instrumentation的声明写到了一起,而没有像Apis Demo那样分开。请注意里面的<uses-library>标签。如果没有那句,在运行测试时会报告找不到TestRunner。这是由于Android在build的时候只把需要的东西打包,所以你必须明确的告诉Android Builder这一点。
3. Build和Install
在Eclipse上,这两个步骤是一起完成的。只要点一下Run即可。只不过如果你不在Run Configuration里将安装后的Launch Action设为“Do Nothing”,就会自动运行一下你的MainActivity。对于我们,设为Do Nothing即可。如下图:
完成后,利用命令
adb shell pm list packages
可以在已经安装的pkg列表里看到com.android.testapp。
4. 运行测试,查看结果
之后就打开命令行,运行以下命令
adb shell am instrument –e class com.android.testapp.test.TestMainActivity –w com.android.testapp/android.test.InstrumentationTestRunner
即可看到如下的结果:
可以看到,单元测试正确的找到了减法中的错误。结果中的成功的测试显示为”.”,一个失败的显示为”F”。只不过我还是不太理解为什么我只写了两个测试方法,Tests run却显示了3。