测试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();
  8.         setActivityInitialTouchMode(true);
  10.         mClickFunActivity = getActivity();
  11.         mClickMeButton = (Button)
  12.                 mClickFunActivity
  13.                 .findViewById(R.id.launch_next_activity_button);
  14.         mInfoTextView = (TextView)
  15.                 mClickFunActivity.findViewById(R.id.info_text_view);
  16.     }
  17. }

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

UI测试目标应包括:

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

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

验证Button布局参数

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

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

在调用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