編寫:huanglizhuo - 原文:http://developer.android.com/training/activity-testing/activity-ui-testing.html
通常情況下,Activity,包括用戶界面組件(如按鈕,復(fù)選框,可編輯的文本域,和選框)允許用戶與Android應(yīng)用程序交互。本節(jié)介紹如何對一個簡單的帶有按鈕的界面交互測試。我們可以使用相同的步驟來測試其他更復(fù)雜的UI組件。
注意: 這一節(jié)的測試方法叫做白盒測試,因為我們擁有要測試應(yīng)用程序的源碼。Android Instrumentation框架適用于創(chuàng)建應(yīng)用程序中UI部件的白盒測試。用戶界面測試的另一種類型是黑盒測試,即無法得知應(yīng)用程序源代碼的類型。這種類型的測試可以用來測試應(yīng)用程序如何與其他應(yīng)用程序,或與系統(tǒng)進行交互。黑盒測試不包括在本節(jié)中。了解更多關(guān)于如何在你的Android應(yīng)用程序進行黑盒測試,請閱讀UI Testing guide。
要參看完整的測試案例,可以查看本節(jié)示例代碼中的ClickFunActivityTest.java文件。
當(dāng)測試擁有UI的Activity時,被測試的Activity在UI線程中運行。然而,測試程序會在程序自己的進程中,單獨的一個線程內(nèi)運行。這意味著,我們的測試程序可以獲得UI線程的對象,但是如果它嘗試改變UI線程對象的值,會得到WrongThreadException錯誤。
為了安全地將Intent注入到Activity,或是在UI線程中執(zhí)行測試方法,我們可以讓測試類繼承于ActivityInstrumentationTestCase2。要學(xué)習(xí)如何在UI線程運行測試方法,請看在UI線程測試。
當(dāng)為UI測試建立測試數(shù)據(jù)集時,我們應(yīng)該在setUp()方法中指定touch mode。把touch mode設(shè)置為真可以防止在執(zhí)行編寫的測試方法時,人為的UI操作獲取到控件的焦點(比如,一個按鈕會觸發(fā)它的點擊監(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);
}
}
UI測試目標(biāo)應(yīng)包括:
. 檢驗Activity啟動時Button在正確布局位置顯示。 . 檢驗TextView初始化時是隱藏的。 *. 檢驗TextView在Button點擊時顯示預(yù)期的字符串
接下來的部分會演示怎樣實現(xiàn)上述驗證方法
我們應(yīng)該像如下添加的測試方法那樣。驗證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()方法時,傳遞根視圖以及期望呈現(xiàn)在屏幕上的視圖作為參數(shù)。如果想呈現(xiàn)的視圖沒有在根視圖中,該方法會拋出一個AssertionFailedError異常,否則測試通過。
我們也可以通過獲取一個ViewGroup.LayoutParams對象的引用驗證Button布局是否正確,然后調(diào)用assert方法驗證Button對象的寬高屬性值是否與預(yù)期值一致。
@MediumTest注解指定測試是如何歸類的(和它的執(zhí)行時間相關(guān))。要了解更多有關(guān)測試的注解,見本節(jié)示例。
可以像這樣添加一個測試方法來驗證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()方法得到一個Activity中修飾試圖(Decor View)的引用。要修飾的View在布局層次視圖中是最上層的ViewGroup(FrameLayout)
可以使用如下測試方法來驗證當(dāng)按下按鈕時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()可以讓我們用編程方式點擊一個按鈕。我們必須傳遞正在運行的測試用例的一個引用和要操作按鈕的引用。
注意:TouchUtils輔助類提供與應(yīng)用程序交互的方法可以方便進行模擬觸摸操作。我們可以使用這些方法來模擬點擊,輕敲,或應(yīng)用程序屏幕拖動View。
警告TouchUtils方法的目的是將事件安全地從測試線程發(fā)送到UI線程。我們不可以直接在UI線程或任何標(biāo)注@UIThread的測試方法中使用TouchUtils這樣做可能會增加錯誤線程異常。
標(biāo)志該測試方法是小型測試的一部分。
標(biāo)志該測試方法是中等測試的一部分。
標(biāo)志該測試方法是大型測試的一部分。
通常情況下,如果測試方法只需要幾毫秒的時間,那么它應(yīng)該被標(biāo)記為@SmallTest,長時間運行的測試(100毫秒或更多)通常被標(biāo)記為@MediumTest或@LargeTest,這主要取決于測試訪問資源在網(wǎng)絡(luò)上或在本地系統(tǒng)。 可以參看Android Tools Protip,它可以更好地指導(dǎo)我們使用測試注釋
我們可以創(chuàng)建其它的測試注釋來控制測試的組織和運行。要了解更多關(guān)于其他注釋的信息,見Annotation類參考。
本節(jié)示例代碼AndroidTestingFun.zip