android-espresso开始使用android-espresso


备注

本节概述了android-espresso是什么,以及开发人员为什么要使用它。

它还应该提到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