编写:huanglizhuo - 原文:http://developer.android.com/training/activity-testing/activity-ui-testing.html
通常情况下,Activity,包括用户界面组件(如按钮,复选框,可编辑的文本域,和选框)允许用户与Android应用程序交互。本节介绍如何对一个简单的带有按钮的界面交互测试。我们可以使用相同的步骤来测试其他更复杂的UI组件。
注意: 这一节的测试方法叫做白盒测试,因为我们拥有要测试应用程序的源码。Android Instrumentation框架适用于创建应用程序中UI部件的白盒测试。用户界面测试的另一种类型是黑盒测试,即无法得知应用程序源代码的类型。这种类型的测试可以用来测试应用程序如何与其他应用程序,或与系统进行交互。黑盒测试不包括在本节中。了解更多关于如何在你的Android应用程序进行黑盒测试,请阅读UI Testing guide。
要参看完整的测试案例,可以查看本节示例代码中的ClickFunActivityTest.java
文件。
当测试拥有UI的Activity时,被测试的Activity在UI线程中运行。然而,测试程序会在程序自己的进程中,单独的一个线程内运行。这意味着,我们的测试程序可以获得UI线程的对象,但是如果它尝试改变UI线程对象的值,会得到WrongThreadException
错误。
为了安全地将Intent
注入到Activity
,或是在UI线程中执行测试方法,我们可以让测试类继承于ActivityInstrumentationTestCase2。要学习如何在UI线程运行测试方法,请看在UI线程测试。
当为UI测试建立测试数据集时,我们应该在setUp()方法中指定touch mode。把touch mode设置为真可以防止在执行编写的测试方法时,人为的UI操作获取到控件的焦点(比如,一个按钮会触发它的点击监听器)。确保在调用getActivity()方法前调用了setActivityInitialTouchMode。
比如:
public class ClickFunActivityTest
extends ActivityInstrumentationTestCase2 {
...
@Override
protected void setUp() throws Exception {
super.setUp();
setActivityInitialTouchMode(true);
mClickFunActivity = getActivity();
mClickMeButton = (Button)
mClickFunActivity
.findViewById(R.id.launch_next_activity_button);
mInfoTextView = (TextView)
mClickFunActivity.findViewById(R.id.info_text_view);
}
}
UI测试目标应包括:
*. 检验Activity启动时Button在正确布局位置显示。 *. 检验TextView初始化时是隐藏的。 *. 检验TextView在Button点击时显示预期的字符串
接下来的部分会演示怎样实现上述验证方法
我们应该像如下添加的测试方法那样。验证Activity中的按钮是否正确显示:
@MediumTest
public void testClickMeButton_layout() {
final View decorView = mClickFunActivity.getWindow().getDecorView();
ViewAsserts.assertOnScreen(decorView, mClickMeButton);
final ViewGroup.LayoutParams layoutParams =
mClickMeButton.getLayoutParams();
assertNotNull(layoutParams);
assertEquals(layoutParams.width, WindowManager.LayoutParams.MATCH_PARENT);
assertEquals(layoutParams.height, WindowManager.LayoutParams.WRAP_CONTENT);
}
在调用assertOnScreen()方法时,传递根视图以及期望呈现在屏幕上的视图作为参数。如果想呈现的视图没有在根视图中,该方法会抛出一个AssertionFailedError异常,否则测试通过。
我们也可以通过获取一个ViewGroup.LayoutParams对象的引用验证Button布局是否正确,然后调用assert
方法验证Button对象的宽高属性值是否与预期值一致。
@MediumTest
注解指定测试是如何归类的(和它的执行时间相关)。要了解更多有关测试的注解,见本节示例。
可以像这样添加一个测试方法来验证TextView最初是隐藏在Activity中的:
@MediumTest
public void testInfoTextView_layout() {
final View decorView = mClickFunActivity.getWindow().getDecorView();
ViewAsserts.assertOnScreen(decorView, mInfoTextView);
assertTrue(View.GONE == mInfoTextView.getVisibility());
}
我们可以调用getDecorView()
方法得到一个Activity中修饰试图(Decor View)的引用。要修饰的View在布局层次视图中是最上层的ViewGroup(FrameLayout)
可以使用如下测试方法来验证当按下按钮时TextView变得可见:
@MediumTest
public void testClickMeButton_clickButtonAndExpectInfoText() {
String expectedInfoText = mClickFunActivity.getString(R.string.info_text);
TouchUtils.clickView(this, mClickMeButton);
assertTrue(View.VISIBLE == mInfoTextView.getVisibility());
assertEquals(expectedInfoText, mInfoTextView.getText());
}
在测试中调用clickView()可以让我们用编程方式点击一个按钮。我们必须传递正在运行的测试用例的一个引用和要操作按钮的引用。
注意:TouchUtils辅助类提供与应用程序交互的方法可以方便进行模拟触摸操作。我们可以使用这些方法来模拟点击,轻敲,或应用程序屏幕拖动View。
警告TouchUtils方法的目的是将事件安全地从测试线程发送到UI线程。我们不可以直接在UI线程或任何标注@UIThread的测试方法中使用TouchUtils这样做可能会增加错误线程异常。
标志该测试方法是小型测试的一部分。
标志该测试方法是中等测试的一部分。
标志该测试方法是大型测试的一部分。
通常情况下,如果测试方法只需要几毫秒的时间,那么它应该被标记为@SmallTest,长时间运行的测试(100毫秒或更多)通常被标记为@MediumTest或@LargeTest,这主要取决于测试访问资源在网络上或在本地系统。 可以参看Android Tools Protip,它可以更好地指导我们使用测试注释
我们可以创建其它的测试注释来控制测试的组织和运行。要了解更多关于其他注释的信息,见Annotation类参考。
本节示例代码AndroidTestingFun.zip