android-espresso开始使用android-espresso

备注

浓缩咖啡设置说明

• 设置您的测试环境
• 下载浓缩咖啡
• 设置仪表运行器
• 示例build.gradle文件
• Analytics（分析）
• 添加第一个测试
• 运行测试本指南介绍如何使用SDK Manager安装Espresso并使用Gradle进行构建。建议使用Android Studio。

设置您的测试环境

为避免瑕疵，我们强烈建议您关闭用于测试的虚拟或物理设备上的系统动画。

在您的设备上，在Settings-> Developer options下，禁用以下3个设置：

• 窗口动画比例
• 过渡动画比例
• 动画师持续时间刻度

下载浓缩咖啡

• 确保您已在Extras下安装了最新的Android Support Repository（请参阅说明）。

• 打开应用程序的build.gradle文件。这通常不是顶级build.gradle文件，而是app / build.gradle。

• 在依赖项中添加以下行：

  androidTestCompile'c​​om.android.support.test.espresso：espresso-core：2.2.2'androidTestCompile'c​​om.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基本上有三个组成部分：

1. ViewMatchers - 允许在当前视图层次结构中查找视图

2. ViewActions - 允许对视图执行操作

3. ViewAssertions - 允许断言视图的状态

基础浓咖啡测试

onView(ViewMatcher)       -- 1     
 .perform(ViewAction)     -- 2
   .check(ViewAssertion); -- 3
 

1. 找到视图
2. 对视图执行操作
3. 验证断言

检查选项菜单项（使用Spoon来截取屏幕截图）

/**
 * @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()));
    }
}
 

按ID查找一些视图

onView(withId(R.id.pay))
 

按文字查找视图

onView(withText("Pay"))
onView(withText(R.string.pay))
 

Hello World Espresso示例

这是一个创建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 类来启动测试。然后，这个测试做了三件事：

1. 它检查textview是否包含空字符串（“”）
2. 它单击我们布局中的按钮
3. 如果它包含“Hello World！”，它会再次检查textview的文本。

顶部的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
 

PDF - Download android-espresso for free