Android Espresso


Android Espresso浅谈


简介

Espresso 也是一款自动化测试的框架,和UiAutomator类似。
基本上使用流程和UiAutomator类似。

步骤:

  • 查找元素:找到UI上测试的元素位置,比如找到一个按钮
  • 执行操作:给某个元素执行一个动作,比如触发按钮的点击事件
  • 检查结果:判断做出的动作是否符合期望,比如按钮点击后,是否符合我的期望

准备

集成Espresso,首先需要保证App项目已经依赖了Gradle Testing。然后在gradle中添加如下依赖即可。

dependencies {
    androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.1'
}

创建Test Case

创建一个Espresso测试用例可以按照如下步骤。

  • 找到你想测试的Activity,然后使用onView或者onData来查找UI元素
  • 模拟用户用户点击,可以调用 ViewInteraction.perform() or DataInteraction.perform(),为了顺序的给同一个组件执行一些列的动作,可以使用链式的调用方式调用,中间使用逗号分隔,相当于传入一个动作数组。

下面是官方网站给出的一个例子,

onView(withId(R.id.my_view))            // withId(R.id.my_view) is a ViewMatcher
        .perform(click())               // click() is a ViewAction
        .check(matches(isDisplayed())); // matches(isDisplayed()) is a ViewAssertion

使用ActivityTestRule创建Espresso

接下来的步骤是,使用ActivityTestRule来创建Espresso测试用例,下面是代码示例。@RunWith(AndroidJUnit4.class)设置测试代码怎么运行,@Rule来标注一个测试的Rule。

package com.example.android.testing.espresso.BasicSample;

import org.junit.Before;
import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.RunWith;

import android.support.test.rule.ActivityTestRule;
import android.support.test.runner.AndroidJUnit4;
...

@RunWith(AndroidJUnit4.class)
@LargeTest
public class ChangeTextBehaviorTest {

    private String mStringToBetyped;

    @Rule
    public ActivityTestRule<MainActivity> mActivityRule = new ActivityTestRule<>(
            MainActivity.class);

    @Before
    public void initValidString() {
        // Specify a valid string.
        mStringToBetyped = "Espresso";
    }

    @Test
    public void changeText_sameActivity() {
        // Type text and then press the button.
        onView(withId(R.id.editTextUserInput))
                .perform(typeText(mStringToBetyped), closeSoftKeyboard());
        onView(withId(R.id.changeTextBt)).perform(click());

        // Check that the text was changed.
        onView(withId(R.id.textToBeChanged))
                .check(matches(withText(mStringToBetyped)));
    }
}

使用ActivityInstrumentationTestCase2来创建Espresso

相对于上的测试用例,也可以使用ActivityInstrumentationTestCase2来创建Esprsso测试用例。
下面是代码示例:

import android.support.test.InstrumentationRegistry;
public class MyEspressoTest extends ActivityInstrumentationTestCase2<MyActivity> {

    private MyActivity mActivity;

    public MyEspressoTest() {
        super(MyActivity.class);
    }

    @Before
    public void setUp() throws Exception {
        super.setUp();
        injectInstrumentation(InstrumentationRegistry.getInstrumentation());
        mActivity = getActivity();
    }
}

访问UI元素

对比与UiAutomator,Espresso可以直接根据id来访问元素,同样Espresso也是可以根据文本信息匹配进行访问的。
Espresso 提供onView()方法来访问UI元素,然后在执行一种操作,最后再进行验证。
下面的一个代码示例,表示访问一个EditText,输入一些内容,关闭输入法,最后点击按钮。

public void testChangeText_sameActivity() {
    // Type text and then press the button.
    onView(withId(R.id.editTextUserInput)).perform(typeText(STRING_TO_BE_TYPED), closeSoftKeyboard());
    onView(withId(R.id.changeTextButton)).perform(click());
}

使用withId()进行Id访问,也可以使用withText()进行文本匹配。

Espresso.onView(ViewMatchers.withText("Sign-in"));
Espresso.onView(ViewMatchers.withId(R.id.button_signin));

结合 Hamcrest库中的Matchers,可以使用allOf()来组合选择多个UI元素。

onView(allOf(withId(R.id.button_signin), withText("Sign-in")));
onView(allOf(withId(R.id.button_signin), not(withText("Sign-out"))));

AdapterView

当查找AdapterView之类的组件的时候,它的子元素都是动态生成的,如果要访问这些类的子元素,使用onView就会起不了作用。
Espresso提供onData方法来获取DataInteraction对象,然后在来访问目标元素。Espresso处理加载目标元素到当前层次结构。

注意
onData() 方法不检查找到的元素是否匹配,它只是检查当前层次结构,如果不匹配会抛出NoMatchingviewExption异常。

下面代码演示,使用onData方法加载指定字符串数组的,找到对应的元素。

onData(allOf(is(instanceOf(Map.class)),hasEntry(equalTo(LongListActivity.ROW_TEXT), is(str))));

`

执行动作

调用 ViewInteraction.perform()DataInteraction.perform() ,可以模拟用户执行UI元素的操作。可以指定一个或者多个动作,Espresso会按照指定的顺序,依次发送动作事件,这些动作是线程安全的。
ViewActions 可以提供一些列常用的方法,我们可以利用写方法来操作UI元素。

  • ViewActions.click(): 点击事件
  • ViewActions.typeText(): 输入指定的文字内容
  • ViewActions.scrollTo(): 滑动
  • ViewActions.pressKey(): 按下按键
  • ViewActions.clearText(): 清空文本

校验结果

调用ViewInteraction.check()DataInteraction.check()方法,可以判断UI元素的状态,如果断言失败,会抛出AssertionFailedError异常。
比如:

  • doesNotExist: 断言某一个view不存在
  • matches: 断言某个view存在,且符合一列的匹配
  • selectedDescendentsMatch :断言指定的子元素存在,且他们的状态符合一些列的匹配

如下所示,代码表示查找的元素是否符合指定的字符串。

public void testChangeText_sameActivity() {
    // Type text and then press the button.
    // Check that the text was changed.
    onView(withId(R.id.textToBeChanged)).check(matches(withText(STRING_TO_BE_TYPED)));
}

链接

https://developer.android.com/training/testing/ui-testing/espresso-testing.html


文章作者: 流水不腐小夏
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 流水不腐小夏 !
 上一篇
MockWebServer MockWebServer
MockWebServer 简介MockWebServer Github地址 按照官方文档定义,MockWebServer是一个可脚本化的用于测试HTTP客户端的Web服务器。主要用于测试你的应用在进行HTTP、HTTPS请求时是否按照预期
2016-07-25 流水不腐小夏
下一篇 
Android UIAutomator Android UIAutomator
Android UIAutomator浅谈 简介Uiautomator是谷歌推出的,用于UI自动化测试的工具,也就是普通的手工测试,点击每个控件元素看看输出的结果是否符合预期。比如登陆界面分别输入正确和错误的用户名密码然后点击登陆按钮看看是
2016-07-25
  目录