Android自動測試框架Espresso

不錯的官方文檔翻譯(含作者見解)
這篇文章翻譯簡直太棒了,本文的內容都來自對該文章所記錄的筆記。
Android自動化測試--Espresso框架使用
Android官網,_科學上網也訪問不了跪求原因

如何使用Espresso

  1. 在module級別的Gradle中添加以下配置
android {
    defaultConfig {
        ...
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
}

2.添加依賴

dependencies {
    androidTestCompile 'com.android.support:support-annotations:23.1.1'
    androidTestCompile 'com.android.support.test:runner:0.4.1'
    androidTestCompile 'com.android.support.test:rules:0.4.1'
    androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.1'
}

3.測試代碼編寫
一般來說我們在main/java中放置主要的業務邏輯代碼,在 androidTest/java放置測試代碼.

src/
    androidTest/java    ----這里存放instrumentation test相關的代碼
    main/java           ----這里存放工程代碼

建議測試代碼的分類與被測試類放置在相同的包目錄下,例如待測試的類為src/main/java/package-name/A.java,那么測試類可以放置在src/androidTest/java/package-name/ATest.java目錄下,測試類名稱以Test作為后綴.

Espresso的一些語法

onView() 查找元素,其完整的方法簽名如下:

public static ViewInteraction onView(final Matcher<View> viewMatcher) {}

這個方法接收一個Matcher<View>類型的入參,返回一個ViewInteraction對象,其所做的事情就是根據Matcher<View>所指定的條件,在當前UI頁面上尋找符合條件的View,并且把相應的View返回出來。這樣說還是比較抽象,我們可以用一個具體的例子加以說明。

當我們在實現布局的時候,每個控件都會有一些特殊的屬性來確定其唯一性,比如最常用的R.id。Matcher<View>支持通過控件的唯一ID來從當前頁面上尋找目標控件,對應的方法為withId(),該方法定義如下:

public static Matcher<View> withId(final int id) {}

大家可以看到,該方法接收了一個int類型的入參,返回了一個Matcher<View>對象,于是,采用如下寫法:

onView(withId(id));

我們就能在當前頁面找到指定ID所對應的目標控件了。

實際上,Espresso提供了很多方法來讓我們自定義我們的查找條件。比如我們可以通過withText()方法來尋找顯示了指定文案的控件等等。具體支持的Matcher類型可以參考Espresso cheat sheet

需要提醒大家一點的是,onView()方法在根據匹配條件進行查找時,它的目標是找到唯一的一個目標控件。如果我們制定的匹配條件有多個控件可以匹配(比如復用了layout的布局,或者顯示相同文字的TextView等),該方法會拋出一個AmbiguousViewMatcherException異常,因此我們在構造匹配條件時,一定要確保能查找到的目標控件是唯一的。

如果單一的匹配條件無法精確地匹配出來唯一的控件,我們可能還需要額外的匹配條件,此時可以用allOf()方法來進行復合匹配條件的構造:

onView(allOf(withId(id), withText(text)))

以上代碼可以查找ID為id同時顯示的文字內容為text的控件。這里需要注意的是,為了保證自動化測試的效率,我們應盡可能減少匹配條件的數量。如果用一個匹配條件能夠滿足我們的需求,我們也就沒有必要再用allOf()來構造復合匹配條件了。

操作元素

public ViewInteraction perform(final ViewAction... viewActions) {}

該方法定義在ViewInteraction類里面。還記得onView()方法的返回值么?yes,正是一個ViewInteraction對象。因此,我們可以在onView()方法找到的元素上直接調用perform()方法進行一系列操作:

onView(withId(id)).perform(click())

如上代碼對onView()查詢到的元素做了一次點擊的操作。請注意,perform()方法的入參是變長參數,也就意味著,我們可以依次對某個元素做多個操作:

onView(withId(id)).perform(click(), replaceText(text), closeSoftKeyboard())

以上代碼對目標元素依次做了點擊、輸入文本、關閉輸入法鍵盤的操作。這是一個典型的填寫表單的行為。

檢查結果

到目前為止,我們已經能找到元素,也能夠對元素進行一些操作了!接下來我們需要檢查一下這些操作的結果是否符合我們的預期。

Espresso提供了一個check()方法用來檢測結果:

public ViewInteraction check(final ViewAssertion viewAssert) {}

該方法接收了一個ViewAssertion的入參,該入參的作用就是檢查結果是否符合我們的預期。一般來說,我們可以調用如下的方法來自定義一個ViewAssertion:

public static ViewAssertion matches(final Matcher<? super View> viewMatcher) {}

這個方法接收了一個匹配規則,然后根據這個規則為我們生成了一個ViewAssertion對象!還記得Matcher這個類型么!!是的,這就是onView()方法的入參!實際上他們是同一個類型,其使用方法也是完全一致的。

比如,我想檢查一下指定id的TextView是否按照我的預期顯示了一段text文本,那么我就可以這樣寫:

onView(withId(id)).check(matches(withText(text)))

簡潔明了。ViewAssertion的支持也可以參照這個Espresso cheat sheet

AdapterView

對于類似ListView這種有UI復用的元素來說,只是通過onView()就顯得復雜了一點,我們來看一下針對這種情況應有何種方案。

AdapterView是一種通過Adapter來動態加載數據的界面元素。我們常用的ListView, GridView, Spinner等等都屬于AdapterView。不同于我們之前提到的靜態的控件,AdapterView在加載數據時,可能只有一部分顯示在了屏幕上,對于沒有顯示在屏幕上的那部分數據,我們通過onView()是沒有辦法找到的。

對于AdapterView,Espresso提供了如下方法用來查找元素:

/**
 * Creates an {@link DataInteraction} for a data object displayed by the application. Use this
 * method to load (into the view hierarchy) items from AdapterView widgets (e.g. ListView).
 *
 * @param dataMatcher a matcher used to find the data object.
 */
public static DataInteraction onData(Matcher<? extends Object> dataMatcher) {}

我們首先來研究一下這個方法的返回值。從以上定義可以看出,該方法返回了一個DataInteraction對象,還記得onView()方法返回的ViewInteraction對象么?這兩者的區別可以大概描述為:

  • ViewInteraction: 關注于已經匹配到的目標控件。通過onView()方法我們可以找到符合匹配條件的唯一的目標控件,我們只需要針對這個控件進行我們需要的操作。
  • DataInteraction: 關注于AdapterView的數據。由于AdapterView的數據源可能很長,很多時候無法一次性將所有數據源顯示在屏幕上,因此我們主要先關注AdapterView中包含的數據,而非一次性就進行View的匹配。

我們再來研究一下這個方法的入參。從以上定義看出,該方法接收了一個Matcher<? extends Object>的參數,該參數用來指定一個匹配規則。還記得onView()的入參么?是一個Matcher<View>對象。從類型上來看,這兩者的區別也不言而喻:

  • Matcher<View>: 構造一個針對于View匹配的匹配規則;
  • Matcher<? extends Object>: 構造一個針對于Object(數據)匹配的匹配規則。

從以上對比可以看出,我們在使用onData()方法對AdapterView進行測試的時候,我們的思路就轉變成了首先關注這個AdapterView的具體數據,而不是UI上呈現的內容。當然,我們最終的目標還是要找到目標的UI元素,但是我們是通過其數據源來進行入手的。

尋找數據

那么,接下來,我們就要學習如何去尋找我們需要的數據了!顯然,要想找到我們需要的數據,就需要構造一個onData()所使用的Matcher對象,而這個對象的構造和使用實際上和之前我們所用的針對于View的Matcher大概雷同。比如,我們可以指定單一條件:

onData(is(instanceOf(MyObject.class)))

表示我們需要找一個AdapterView,其數據源的類型是MyObject(這是一個自定義的類)。當然了,我們肯定還是需要更加精確地去尋找一個AdapterView中的指定條目,于是我們可以采用allOf()來構造一個符合匹配條件:

onData(allOf(is(instanceOf(MyObject.class)), myCustomMatcher()))

如上代碼便使用allOf()方法構造了一個符合匹配規則。而上面的myCustomMatcher()方法構造了一個自定義的Matcher,我們可以采用自己的自定義Matcher來更加精準地進行數據的匹配。

//TODO

自定義Matcher

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,182評論 6 543
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,489評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,290評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,776評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,510評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,866評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,860評論 3 447
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,036評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,585評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,331評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,536評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,058評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,754評論 3 349
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,154評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,469評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,273評論 3 399
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,505評論 2 379

推薦閱讀更多精彩內容