测试UI组件

编写:huanglizhuo - 原文:http://developer.android.com/training/activity-testing/activity-ui-testing.html

通常情况下,Activity,包括用户界面组件(如按钮,复选框,可编辑的文本域,和选框)允许用户与Android应用程序交互。本节介绍如何对一个简单的带有按钮的界面交互测试。我们可以使用相同的步骤来测试其他更复杂的UI组件。

注意: 这一节的测试方法叫做白盒测试,因为我们拥有要测试应用程序的源码。Android Instrumentation框架适用于创建应用程序中UI部件的白盒测试。用户界面测试的另一种类型是黑盒测试,即无法得知应用程序源代码的类型。这种类型的测试可以用来测试应用程序如何与其他应用程序,或与系统进行交互。黑盒测试不包括在本节中。了解更多关于如何在你的Android应用程序进行黑盒测试,请阅读UI Testing guide

要参看完整的测试案例,可以查看本节示例代码中的ClickFunActivityTest.java文件。

使用 Instrumentation 建立UI测试

当测试拥有UI的Activity时,被测试的Activity在UI线程中运行。然而,测试程序会在程序自己的进程中,单独的一个线程内运行。这意味着,我们的测试程序可以获得UI线程的对象,但是如果它尝试改变UI线程对象的值,会得到WrongThreadException错误。

为了安全地将Intent注入到Activity,或是在UI线程中执行测试方法,我们可以让测试类继承于ActivityInstrumentationTestCase2。要学习如何在UI线程运行测试方法,请看在UI线程测试

建立测试数据集(Fixture)

当为UI测试建立测试数据集时,我们应该在setUp()方法中指定touch mode。把touch mode设置为真可以防止在执行编写的测试方法时,人为的UI操作获取到控件的焦点(比如,一个按钮会触发它的点击监听器)。确保在调用getActivity()方法前调用了setActivityInitialTouchMode)。

比如:

  1. public class ClickFunActivityTest
  2. extends ActivityInstrumentationTestCase2 {
  3. ...
  4. @Override
  5. protected void setUp() throws Exception {
  6. super.setUp();
  7. setActivityInitialTouchMode(true);
  8. mClickFunActivity = getActivity();
  9. mClickMeButton = (Button)
  10. mClickFunActivity
  11. .findViewById(R.id.launch_next_activity_button);
  12. mInfoTextView = (TextView)
  13. mClickFunActivity.findViewById(R.id.info_text_view);
  14. }
  15. }

添加测试方法确认UI响应表现

UI测试目标应包括:

. 检验Activity启动时Button在正确布局位置显示。 . 检验TextView初始化时是隐藏的。
*. 检验TextViewButton点击时显示预期的字符串

接下来的部分会演示怎样实现上述验证方法

验证Button布局参数

我们应该像如下添加的测试方法那样。验证Activity中的按钮是否正确显示:

  1. @MediumTest
  2. public void testClickMeButton_layout() {
  3. final View decorView = mClickFunActivity.getWindow().getDecorView();
  4. ViewAsserts.assertOnScreen(decorView, mClickMeButton);
  5. final ViewGroup.LayoutParams layoutParams =
  6. mClickMeButton.getLayoutParams();
  7. assertNotNull(layoutParams);
  8. assertEquals(layoutParams.width, WindowManager.LayoutParams.MATCH_PARENT);
  9. assertEquals(layoutParams.height, WindowManager.LayoutParams.WRAP_CONTENT);
  10. }

在调用assertOnScreen()方法时,传递根视图以及期望呈现在屏幕上的视图作为参数。如果想呈现的视图没有在根视图中,该方法会抛出一个AssertionFailedError异常,否则测试通过。

我们也可以通过获取一个ViewGroup.LayoutParams对象的引用验证Button布局是否正确,然后调用assert方法验证Button对象的宽高属性值是否与预期值一致。

@MediumTest注解指定测试是如何归类的(和它的执行时间相关)。要了解更多有关测试的注解,见本节示例。

验证TextView的布局参数

可以像这样添加一个测试方法来验证TextView最初是隐藏在Activity中的:

  1. @MediumTest
  2. public void testInfoTextView_layout() {
  3. final View decorView = mClickFunActivity.getWindow().getDecorView();
  4. ViewAsserts.assertOnScreen(decorView, mInfoTextView);
  5. assertTrue(View.GONE == mInfoTextView.getVisibility());
  6. }

我们可以调用getDecorView()方法得到一个Activity中修饰试图(Decor View)的引用。要修饰的View在布局层次视图中是最上层的ViewGroup(FrameLayout)

验证按钮的行为

可以使用如下测试方法来验证当按下按钮时TextView变得可见:

  1. @MediumTest
  2. public void testClickMeButton_clickButtonAndExpectInfoText() {
  3. String expectedInfoText = mClickFunActivity.getString(R.string.info_text);
  4. TouchUtils.clickView(this, mClickMeButton);
  5. assertTrue(View.VISIBLE == mInfoTextView.getVisibility());
  6. assertEquals(expectedInfoText, mInfoTextView.getText());
  7. }

在测试中调用clickView()可以让我们用编程方式点击一个按钮。我们必须传递正在运行的测试用例的一个引用和要操作按钮的引用。

注意:TouchUtils辅助类提供与应用程序交互的方法可以方便进行模拟触摸操作。我们可以使用这些方法来模拟点击,轻敲,或应用程序屏幕拖动View。

警告TouchUtils方法的目的是将事件安全地从测试线程发送到UI线程。我们不可以直接在UI线程或任何标注@UIThread的测试方法中使用TouchUtils这样做可能会增加错误线程异常。

应用测试注解

@SmallTest

  1. 标志该测试方法是小型测试的一部分。

@MediumTest

  1. 标志该测试方法是中等测试的一部分。

@LargeTest

  1. 标志该测试方法是大型测试的一部分。

通常情况下,如果测试方法只需要几毫秒的时间,那么它应该被标记为@SmallTest,长时间运行的测试(100毫秒或更多)通常被标记为@MediumTest@LargeTest,这主要取决于测试访问资源在网络上或在本地系统。 可以参看Android Tools Protip,它可以更好地指导我们使用测试注释

我们可以创建其它的测试注释来控制测试的组织和运行。要了解更多关于其他注释的信息,见Annotation类参考。

本节示例代码AndroidTestingFun.zip