本节概述了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