本節概述了android-espresso是什麼,以及開發人員為什麼要使用它。
它還應該提到android-espresso中的任何大型主題,並鏈接到相關主題。由於android-espresso的文檔是新的,您可能需要創建這些相關主題的初始版本。
設置您的測試環境
為避免瑕疵,我們強烈建議您關閉用於測試的虛擬或物理設備上的系統動畫。
在您的設備上,在Settings-> Developer options下,禁用以下3個設置:
下載濃縮咖啡
確保您已在Extras下安裝了最新的Android Support Repository(請參閱說明)。
打開應用程序的build.gradle文件。這通常不是頂級build.gradle文件,而是app / build.gradle。
在依賴項中添加以下行:
androidTestCompile'com.android.support.test.espresso:espresso-core:2.2.2'androidTestCompile'com.android.support.test:runner:0.5'
有關更多工件,請參閱下載部分(espresso-contrib,espresso-web等)
設置儀表運行器
將相同的build.gradle文件添加到android.defaultConfig中的以下行:testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
示例build.gradle文件
apply plugin: 'com.android.application'
android {
compileSdkVersion 22
buildToolsVersion "22"
defaultConfig {
applicationId "com.my.awesome.app"
minSdkVersion 10
targetSdkVersion 22.0.1
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
}
dependencies {
// App's dependencies, including test
compile 'com.android.support:support-annotations:22.2.0'
// Testing-only dependencies
androidTestCompile 'com.android.support.test:runner:0.5'
androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.2'
}
Analytics(分析)
為了確保每個新版本都在正確的軌道上,測試運行器會收集分析。更具體地說,它為每次調用上傳待測應用程序的包名稱的哈希值。這使我們可以使用Espresso測量獨特包裝的數量以及使用量。
如果您不希望上傳此數據,可以通過將以下參數傳遞給測試運行器來選擇退出:disableAnalytics“true”(請參閱如何傳遞自定義參數)。
添加第一個測試
Android Studio默認在src / androidTest / java / com.example.package /中創建測試
使用規則的示例JUnit4測試:
@RunWith(AndroidJUnit4.class)
@LargeTest
public class HelloWorldEspressoTest {
@Rule
public ActivityTestRule<MainActivity> mActivityRule = new ActivityTestRule(MainActivity.class);
@Test
public void listGoesOverTheFold() {
onView(withText("Hello world!")).check(matches(isDisplayed()));
}
}
運行測試
在Android Studio中
創建測試配置
在Android Studio中:
打開運行菜單 - >編輯配置
添加新的Android測試配置
選擇一個模塊
添加特定的儀表運行器:
android.support.test.runner.AndroidJUnitRunner
運行新創建的配置。
從命令行到Gradle
執行
./gradlew connectedAndroidTest
Espresso基本上有三個組成部分:
ViewMatchers - 允許在當前視圖層次結構中查找視圖
ViewActions - 允許對視圖執行操作
ViewAssertions - 允許斷言視圖的狀態
基礎濃咖啡測試
onView(ViewMatcher) -- 1
.perform(ViewAction) -- 2
.check(ViewAssertion); -- 3
/**
* @author piotrek1543
*
* This example provides a specific UI testing problem and how it is already solved
* with Google's Espresso. Notice that I used also Spoon framework, as Espresso
* lacks of taking screenshots functionality.
*/
@RunWith(AndroidJUnit4.class)
public class MainActivityAndroidTest {
@Rule
public ActivityTestRule<MainActivity> mRule = new ActivityTestRule<>(MainActivity.class);
@Test
public void checkIfSettingsMenuItemsAreVisible() throws InterruptedException {
//open OptionsMenu to see available items
openActionBarOverflowOrOptionsMenu(mRule.getActivity());
//create a screenshot with 'options_menu' TAG
Spoon.screenshot(mRule.getActivity(), "options_menu");
//check if Settings item is Visible
onView(withText(R.string.action_settings)).check(matches(isDisplayed()));
//check if `Sort` item is Visible
onView(withText(R.string.action_sort)).check(matches(isDisplayed()));
//perform click on `Sort` OptionsMenu item
onView(withText(R.string.action_sort)).perform(click());
//create a screenshot with 'options_menu_sort' TAG
Spoon.screenshot(mRule.getActivity(), "options_menu_sort");
//check if `Sort -> By Value id` item is Visible
onView(withText(R.string.menu_sort_length)).check(matches(isDisplayed()));
//check if `Sort -> By Joke length` item is Visible
onView(withText(R.string.menu_sort_a_z)).check(matches(isDisplayed()));
}
}
onView(withId(R.id.pay))
onView(withText("Pay"))
onView(withText(R.string.pay))
這是一個創建hello world示例的教程:用於此示例:Android Studio 2.3;
要開始使用Android Studio創建具有空活動的新項目。然後我們向App添加一些我們可以測試的簡單功能:我們添加一個按鈕,當點擊在文本視圖中顯示“Hello World”時。
活動代碼如下所示:
package com.example.testing.helloworld;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.TextView;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
final TextView textView = (TextView) findViewById(R.id.textView);
findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
textView.setText("Hello World!");
}
});
}
}
此活動的activity_main
佈局如下所示:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<TextView
android:id="@+id/textView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="" />
<Button
android:id="@+id/button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Say Hello" />
</LinearLayout>
現在我們想要使用espresso來測試這個新創建的應用程序的行為。通常,您的應用程序本身的代碼在main
包中,單元測試在內部test
,espresso檢測測試在androidTest
包內。如果您使用Android Studio創建一個新的空活動項目,它應該已經創建了這些包和類,它應該如下所示:
要從espresso開始,我們必須確保espresso-core
依賴項包含在build.gradle
文件中(請注意,它不是使用compile
關鍵字註釋,而是使用androidTestCompile
)。 Android studio創建的build.gradle
文件中的依賴項應如下所示:
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:25.2.0'
compile 'com.android.support.constraint:constraint-layout:1.0.2'
testCompile 'junit:junit:4.12'
}
現在已經完成所有設置,我們可以從實際測試開始:打開ExampleInstrumentationTest
文件,您會看到已經有一個生成的useAppContext
測試。我們將更改此測試類並創建測試以檢查我們的應用程序行為:
@RunWith(AndroidJUnit4.class)
public class ExampleInstrumentedTest {
@Rule
public ActivityTestRule<MainActivity> mActivityRule = new ActivityTestRule<>(
MainActivity.class, false, true);
@Test
public void checkHelloWorld() throws Exception {
onView(withId(R.id.textView)).check(matches(withText("")));
onView(withId(R.id.button)).perform(click());
onView(withId(R.id.textView)).check(matches(withText("Hello World!")));
}
}
通過運行ExampleInstrumentedTest
類來啟動測試。然後,這個測試做了三件事:
頂部的ActivityTestRule定義測試哪個活動,並在測試開始時啟動它。 (您也可以自動啟動活動,然後手動在每個測試中啟動它)
測試規則非常簡單:
onView(withId(R.id.textView))
通過activity_main
佈局文件中的視圖ID在當前屏幕內查找視圖。 .check(matches(withText("")));
然後在該視圖上執行測試用例。 .perform(click())
對視圖執行操作:此操作可以是點擊,長按或滑動等。 這是一個從android espresso Instrumentation測試開始的教程,我希望它給了你一些見解!
onView(withId(R.id.greet_button)) // withId(R.id.my_view) is a ViewMatcher
.perform(click()) // click() is a ViewAction
.check(matches(not(isEnabled())); // matches(isEnabled()) is a ViewAssertion