Android 測試UI組件

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

通常情況下，Activity，包括用戶界面組件（如按鈕，復(fù)選框，可編輯的文本域，和選框）允許用戶與Android應(yīng)用程序交互。本節(jié)介紹如何對一個(gè)簡單的帶有按鈕的界面交互測試。我們可以使用相同的步驟來測試其他更復(fù)雜的UI組件。

注意: 這一節(jié)的測試方法叫做白盒測試，因?yàn)槲覀儞碛幸獪y試應(yīng)用程序的源碼。Android Instrumentation框架適用于創(chuàng)建應(yīng)用程序中UI部件的白盒測試。用戶界面測試的另一種類型是黑盒測試，即無法得知應(yīng)用程序源代碼的類型。這種類型的測試可以用來測試應(yīng)用程序如何與其他應(yīng)用程序，或與系統(tǒng)進(jìn)行交互。黑盒測試不包括在本節(jié)中。了解更多關(guān)于如何在你的Android應(yīng)用程序進(jìn)行黑盒測試，請閱讀UI Testing guide。

要參看完整的測試案例，可以查看本節(jié)示例代碼中的ClickFunActivityTest.java文件。

使用 Instrumentation 建立UI測試

當(dāng)測試擁有UI的Activity時(shí)，被測試的Activity在UI線程中運(yùn)行。然而，測試程序會在程序自己的進(jìn)程中，單獨(dú)的一個(gè)線程內(nèi)運(yùn)行。這意味著，我們的測試程序可以獲得UI線程的對象，但是如果它嘗試改變UI線程對象的值，會得到WrongThreadException錯(cuò)誤。

為了安全地將Intent注入到Activity，或是在UI線程中執(zhí)行測試方法，我們可以讓測試類繼承于ActivityInstrumentationTestCase2。要學(xué)習(xí)如何在UI線程運(yùn)行測試方法，請看在UI線程測試。

建立測試數(shù)據(jù)集（Fixture）

當(dāng)為UI測試建立測試數(shù)據(jù)集時(shí)，我們應(yīng)該在setUp()方法中指定touch mode。把touch mode設(shè)置為真可以防止在執(zhí)行編寫的測試方法時(shí)，人為的UI操作獲取到控件的焦點(diǎn)（比如,一個(gè)按鈕會觸發(fā)它的點(diǎn)擊監(jiān)聽器）。確保在調(diào)用getActivity()方法前調(diào)用了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);
    }
}

添加測試方法確認(rèn)UI響應(yīng)表現(xiàn)

UI測試目標(biāo)應(yīng)包括:

. 檢驗(yàn)Activity啟動時(shí)Button在正確布局位置顯示。 . 檢驗(yàn)TextView初始化時(shí)是隱藏的。 *. 檢驗(yàn)TextView在Button點(diǎn)擊時(shí)顯示預(yù)期的字符串

接下來的部分會演示怎樣實(shí)現(xiàn)上述驗(yàn)證方法

驗(yàn)證Button布局參數(shù)

我們應(yīng)該像如下添加的測試方法那樣。驗(yàn)證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);
}

在調(diào)用assertOnScreen()方法時(shí)，傳遞根視圖以及期望呈現(xiàn)在屏幕上的視圖作為參數(shù)。如果想呈現(xiàn)的視圖沒有在根視圖中,該方法會拋出一個(gè)AssertionFailedError異常，否則測試通過。

我們也可以通過獲取一個(gè)ViewGroup.LayoutParams對象的引用驗(yàn)證Button布局是否正確，然后調(diào)用assert方法驗(yàn)證Button對象的寬高屬性值是否與預(yù)期值一致。

@MediumTest注解指定測試是如何歸類的（和它的執(zhí)行時(shí)間相關(guān)）。要了解更多有關(guān)測試的注解，見本節(jié)示例。

驗(yàn)證TextView的布局參數(shù)

可以像這樣添加一個(gè)測試方法來驗(yàn)證TextView最初是隱藏在Activity中的:

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

我們可以調(diào)用getDecorView()方法得到一個(gè)Activity中修飾試圖（Decor View）的引用。要修飾的View在布局層次視圖中是最上層的ViewGroup(FrameLayout)

驗(yàn)證按鈕的行為

可以使用如下測試方法來驗(yàn)證當(dāng)按下按鈕時(shí)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());
}

在測試中調(diào)用clickView()可以讓我們用編程方式點(diǎn)擊一個(gè)按鈕。我們必須傳遞正在運(yùn)行的測試用例的一個(gè)引用和要操作按鈕的引用。

注意:TouchUtils輔助類提供與應(yīng)用程序交互的方法可以方便進(jìn)行模擬觸摸操作。我們可以使用這些方法來模擬點(diǎn)擊，輕敲，或應(yīng)用程序屏幕拖動View。

警告TouchUtils方法的目的是將事件安全地從測試線程發(fā)送到UI線程。我們不可以直接在UI線程或任何標(biāo)注@UIThread的測試方法中使用TouchUtils這樣做可能會增加錯(cuò)誤線程異常。

應(yīng)用測試注解

@SmallTest

標(biāo)志該測試方法是小型測試的一部分。

@MediumTest

標(biāo)志該測試方法是中等測試的一部分。

@LargeTest

標(biāo)志該測試方法是大型測試的一部分。

通常情況下，如果測試方法只需要幾毫秒的時(shí)間，那么它應(yīng)該被標(biāo)記為@SmallTest，長時(shí)間運(yùn)行的測試（100毫秒或更多）通常被標(biāo)記為@MediumTest或@LargeTest，這主要取決于測試訪問資源在網(wǎng)絡(luò)上或在本地系統(tǒng)。 可以參看Android Tools Protip，它可以更好地指導(dǎo)我們使用測試注釋

我們可以創(chuàng)建其它的測試注釋來控制測試的組織和運(yùn)行。要了解更多關(guān)于其他注釋的信息，見Annotation類參考。

本節(jié)示例代碼AndroidTestingFun.zip