基本Activity 测试用例

创建一个测试用例

在对应要测试Activity的package路径下新建test包，

项目工程结构.png

在改test路径下新建一个FirstActivityTest类（类名+Test后缀）继承
ActivityTestCase

public class FirstActivityTest extends ActivityInstrumentationTestCase2<FirstActivity> {

private FirstActivity mFirstActivity;
private TextView mFirstTestTextView;

public FirstActivityTest() {
    super(FirstActivity.class);
}
}

构造函数是由测试用的Runner调用，用于初始化测试类的。
测试会在运行任何其它测试方法之前自动执行setUp(Runner调用)方法，可以对一些对象进行赋值

@Override
protected void setUp() throws Exception {
    super.setUp();
    mFirstActivity = getActivity();
    mFirstTestTextView = (TextView) mFirstActivity.findViewById(R.id.first_test_textview);
}

增加一个测试前提检查想要测试的对象是否已经正确地初始化

public void testPreconditions() {
    assertNotNull("mFirstTestActivity is null", mFirstActivity);
    assertNotNull("mFirstTestText is null", mFirstTestTextView);
}

测试方法测试默认文本是否和 strings.xml 资源中定义的文本一样。

public void testFirstTestTextView_labelText() {
    final String expected = mFirstActivity.getString(R.string.hello_world);
    final String actual = mFirstTestTextView.getText().toString();
    assertEquals("mFirstTestText contains wrong text", expected, actual);
}

manifest.xml中注册测试用例

<application
    android:allowBackup="true"
    android:icon="@drawable/ic_launcher"
    android:label="@string/app_name"
    android:theme="@style/AppTheme" >

    <uses-library android:name="android.test.runner" /><!-- 加入测试库  -->

    <activity
        android:name="com.speed.androidtest.FirstActivity"
        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>

<instrumentation
    android:name="android.test.InstrumentationTestRunner"
    android:label="Tests for com.speed.androidtest"
    android:targetPackage="com.speed.androidtest" /><!-- targetPackage 测试类的路径  -->

运行测试用例

项目工程右键Run as ==>Android JUint Test，安装完成后会自动执行测试用例，testFirstTestTextView_labelText执行判断

test_success.png

修改main_activity.xml中的

<TextView
    android:id="@+id/first_test_textview"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="hello" />

执行结果

test_error.png

检测到textview中的文本和资源中定义的不一致

UI组件测试， Button 点击

setUp函数编写

@Override
protected void setUp() throws Exception {
    super.setUp();
    setActivityInitialTouchMode(true);
    mSecondTestUIActivity = getActivity();
    mClickMeButton = (Button) mSecondTestUIActivity.findViewById(R.id.second_test_ui_btn);
}

把touch mode设置为真可以防止在执行编写的测试方法时，人为的UI操作获取到控件的焦点（比如,一个按钮会触发它的点击监听器）。确保在调用getActivity()之前调用setActivityInitialTouchMode(true);

测试布局

@MediumTest
public void testClickMeButton_layout() {
    //获取Activity的最顶层布局
    View decorView = mSecondTestUIActivity.getWindow().getDecorView();
    //检测按钮控件是否在屏幕上
    ViewAsserts.assertOnScreen(decorView, mClickMeButton);
    ViewGroup.LayoutParams layoutParams = mClickMeButton.getLayoutParams();
    assertNotNull(layoutParams);
//检测按钮宽度是否为WRAP_CONTENT
    assertEquals(layoutParams.width, WindowManager.LayoutParams.WRAP_CONTENT);
//检测按钮高度是否为WRAP_CONTENT
    assertEquals(layoutParams.height, WindowManager.LayoutParams.WRAP_CONTENT);
}

测试点击效果

@MediumTest
public void testClickMeButton_click() {
    TouchUtils.clickView(this, mClickMeButton);
}

测试注解

• @SmallTest
  标志该测试方法是小型测试的一部分。

• @MediumTest
  标志该测试方法是中等测试的一部分。

• @LargeTest
  标志该测试方法是大型测试的一部分。

通常情况下，如果测试方法只需要几毫秒的时间，那么它应该被标记为@SmallTest，长时间运行的测试（100毫秒或更多）通常被标记为@MediumTest或@LargeTest，这主要取决于测试访问资源在网络上或在本地系统。

创建单元测试

Android 单元测试

测试类应该继承自ActivityUnitTestCase。继承ActivityUnitTestCase的Activity不会被Android自动启动。要单独启动Activity，我们需要显式的调用startActivity()方法，并传递一个Intent来启动我们的目标Activity。

public class LaunchActivityTest extends ActivityUnitTestCase<LaunchActivity> {

private Intent mLaunchIntent;

public LaunchActivityTest() {
    super(LaunchActivity.class);
}


@Override
protected void setUp() throws Exception {
    super.setUp();
    mLaunchIntent = new Intent(getInstrumentation().getTargetContext(),
            LaunchActivity.class);
}

@MediumTest
public void testPreconditions() {
    startActivity(mLaunchIntent, null, null);
    final Button launchNextButton = (Button) getActivity().findViewById(R.id.launch_next_activity_button);

    assertNotNull("mLaunchActivity is null", getActivity());
    assertNotNull("mLaunchNextButton is null", launchNextButton);
}

启动一个Activity

• Button被按下时，启动的LaunchActivity是否正确。
• 验证启动的Intent是否包含有效的数据。

为了验证一个触发Intent的Button的事件，我们可以使用getStartedActivityIntent()方法。通过使用断言方法，我们可以验证返回的Intent是否为空，以及是否包含了预期的数据来启动下一个Activity。如果两个断言值都是真，那么我们就成功地验证了Activity发送的Intent是正确的了。

@MediumTest
public void testNextActivityWasLaunchedWithIntent() {
    startActivity(mLaunchIntent, null, null);
    final Button launchNextButton = (Button) getActivity().findViewById(R.id.launch_next_activity_button);
    launchNextButton.performClick();

    final Intent launchIntent = getStartedActivityIntent();
    assertNotNull("Intent was null", launchIntent);
    assertTrue(isFinishCalled());


    final String payload = launchIntent.getStringExtra(NextActivity.EXTRAS_PAYLOAD_KEY);
    assertEquals("Payload is empty", LaunchActivity.STRING_PAYLOAD
            , payload);
}

功能测试

要为Activity创建功能测，我们的测试类应该对ActivityInstrumentationTestCase2进行扩展。与ActivityUnitTestCase不同，ActivityInstrumentationTestCase2中的测试可以与Android系统通信，发送键盘输入及点击事件到UI中。

要了解一个完整的测试例子可以参考示例应用中的SenderActivityTest.java。

添加测试方法验证函数的行为

我们的函数测试目标应该包括:

验证UI控制是否正确启动了目标Activity。
验证目标Activity的表现是否按照发送Activity提供的数据呈现。
我们可以这样实现测试方法:

@MediumTest
public void testSendMessageToReceiverActivity() {
final Button sendToReceiverButton = (Button)
        mSenderActivity.findViewById(R.id.send_message_button);

final EditText senderMessageEditText = (EditText)
        mSenderActivity.findViewById(R.id.message_input_edit_text);

// Set up an ActivityMonitor
...

// Send string input value
...

// Validate that ReceiverActivity is started
...

// Validate that ReceiverActivity has the correct data
...

// Remove the ActivityMonitor
...
}

测试会等待匹配的Activity启动，如果超时则会返回null。如果ReceiverActivity启动了，那么先前配置的ActivityMoniter就会收到一次碰撞（Hit）。我们可以使用断言方法验证ReceiverActivity是否的确启动了，以及ActivityMoniter记录的碰撞次数是否按照预想地那样增加。

设立一个ActivityMonitor

为了在应用中监视单个Activity我们可以注册一个ActivityMoniter。每当一个符合要求的Activity启动时，系统会通知ActivityMoniter，进而更新碰撞数目。

通常来说要使用ActivityMoniter，我们可以这样：

使用getInstrumentation()方法为测试用例实现Instrumentation。
使用Instrumentation的一种addMonitor()方法为当前instrumentation添加一个Instrumentation.ActivityMonitor实例。匹配规则可以通过IntentFilter或者类名字符串。
等待开启一个Activity。
验证监视器撞击次数的增加。
移除监视器。
下面是一个例子:

// Set up an ActivityMonitor
ActivityMonitor receiverActivityMonitor =
    getInstrumentation().addMonitor(ReceiverActivity.class.getName(),
    null, false);

// Validate that ReceiverActivity is started
TouchUtils.clickView(this, sendToReceiverButton);
ReceiverActivity receiverActivity = (ReceiverActivity)
    receiverActivityMonitor.waitForActivityWithTimeout(TIMEOUT_IN_MS);
assertNotNull("ReceiverActivity is null", receiverActivity);
assertEquals("Monitor for ReceiverActivity has not been called",
    1, receiverActivityMonitor.getHits());
assertEquals("Activity is of wrong type",
    ReceiverActivity.class, receiverActivity.getClass());

// Remove the ActivityMonitor
getInstrumentation().removeMonitor(receiverActivityMonitor);

使用Instrumentation发送一个键盘输入

如果Activity有一个EditText，我们可以测试用户是否可以给EditText对象输入数值。

通常在ActivityInstrumentationTestCase2中给EditText对象发送串字符，我们可以这样做：

使用runOnMainSync()方法在一个循环中同步地调用requestFocus()。这样，我们的UI线程就会在获得焦点前一直被阻塞。
调用waitForIdleSync()方法等待主线程空闲（也就是说,没有更多事件需要处理）。
调用sendStringSync()方法给EditText对象发送一个我们输入的字符串。
比如:

// Send string input value
getInstrumentation().runOnMainSync(new Runnable() {
@Override
public void run() {
    senderMessageEditText.requestFocus();
}
});
getInstrumentation().waitForIdleSync();
getInstrumentation().sendStringSync("Hello Android!");
getInstrumentation().waitForIdleSync();

Demo地址

https://github.com/huben/AndroidTestCase