基本Activity 测试用例
创建一个测试用例
在对应要测试Activity的package路径下新建test包,
项目工程结构.png
在改test路径下新建一个FirstActivityTest类(类名+Test后缀)继承ActivityTestCase
public class FirstActivityTest extends ActivityInstrumentationTestCase2 {
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中注册测试用例
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
android:name="com.speed.androidtest.FirstActivity"
android:label="@string/app_name" >
android:name="android.test.InstrumentationTestRunner"
android:label="Tests for com.speed.androidtest"
android:targetPackage="com.speed.androidtest" />
运行测试用例
项目工程右键Run as ==>Android JUint Test,安装完成后会自动执行测试用例,testFirstTestTextView_labelText执行判断
test_success.png
修改main_activity.xml中的
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 {
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地址