Espresso浅析和使用

Espresso是一个Google官方提供的Android应用UI自动化测试框架。Google希望,当Android的开发者利用Espresso写完测试用例后,能一边看着测试用例自动执行,一边享受一杯香醇Espresso(浓咖啡)。

Espress有3个特点:

  • 第一个收录在Android Testing Supporting Library底下的测试框架
  • 模拟用户的操作
  • 自动等待,直到UI线程Idle,才会执行测试代码

接下来,将从配置、写用例、运行一步步介绍Espresso的使用。

0. 项目配置

0.1 修改App的build.gradle

  • 在defaultConfig内增加,testInstrumentationRunner “android.support.test.runner.AndroidJUnitRunner”,用来运行脚本
  • 增加packagingOptions,避免编译时候License的冲突
  • 在dependencies中增加相关的引用(androidTestCompile只有在编译测试用例时候才会运行,普通编译不会)

下面是build.gradle中涉及到Espresso配置的内容

android {
    defaultConfig {
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
       }
    }
    packagingOptions {
        exclude 'LICENSE.txt'
    }
}
dependencies {
    // Espresso 相关的引用
    compile 'com.android.support:support-annotations:22.1.1'
    androidTestCompile 'com.android.support:support-annotations:22.1.1'
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.1'){
        exclude group: 'javax.inject'
    }
    androidTestCompile 'com.android.support.test.espresso:espresso-intents:2.1'
    androidTestCompile 'com.android.support.test.espresso:espresso-contrib:2.1'
    androidTestCompile 'com.android.support.test:runner:0.2'
}

0.2 添加TestRunner

点击顶栏菜单Run->Edit Configurations,出现如下的窗口后,点击左上角的”+”,选择”Android Tests”;

修改新Configuration的名字,选中App Module,输入Runner,选择”Show chooer dialog”,点击”OK”完成

1. 写测试用例

1.1 三步曲

写UI自动化测试用例,归结起来就是3步:

定位View控件

操作View控件

校验View控件的状态

对应Espresso,就是以下3个方法的调用:

onView(ViewMatcher)
  .perform(ViewAction)
  .check(ViewAssertion);

其中,onView是用来定位View控件的,perform是操作控件的,check是校验View控件的状态。他们各自都需要再传入对应的参数分别如下:

ViewMatcher,有withId、withText、withClassName等等方法来定位View控件

ViewAction,有click()、longClick()、pressBack()、swipeLeft()等等方法来操作View控件

ViewAssertion,有isEnabled()、isLeftOf()、isChecked()等等方法来校验View控件状态

这里有ViewMatcherViewActionViewAssertion的Cheat Sheet。

1.2 完整测试用例代码

这是一个非常简单的测试用例,通过R.id.button定位控件,对它调用了一下click,最后校验控件是不是enabled状态。这里面有一些注解,@Rule修饰的是被测试的Activity@Test修饰的方法是测试用例。

@RunWith(AndroidJUnit4.class)public class MainActivityTest {    @Rule
    public ActivityTestRule mActivityRule = new ActivityTestRule(MainActivity.class);    @Test
    public void testTextViewDisplay() {
        onView(withId(R.id.button))
            .perform(click())
            .check(matches(isEnabled()));
    }
}

1.3 注意

Getting Started With Espresso 2.0这个视频中提到了2个写测试用例时的注意项:

避免Activity的层级跳转,测试用例尽量只在单个Activity内完成。Activity层级跳转越多,越容易出错

强烈不推荐,直接获取View的对象,调用View的方法来模拟用户操作。应该统一使用Espresso提供的方法

测试用例,特别是UI自动化测试用例,应该尽量保持逻辑简单,覆盖关键路径就足矣。因为UI变动是很频繁的,越复杂,维护成本就越高,投入产出比就会自然降低了。

2. 运行用例

  1. 在运行菜单中选择步骤0.2中设置的TestRunner,点击执行
  2. 测试用例模拟用户操作自动运行
  3. 测试用例执行完成,在Android Studio的控制台上,能看到如下的结果输出

其中,看到”Done 3 of 3”标识,一共3个检查点,都检查通过了。如果有检查不通过的话,右上角的绿色能量条会变成红色。

3. 进阶

3.1 onData的使用

对于ListView,如果要操作其中的某一个item,特别是不可见状态的item,是不能通过上述的ViewMatch来定位的。我们都知道ListViewView是复用的,不可见状态的item并没有把内容绘制到View上。Espresso针对AdapterViewListView的父类),提供了onData来支持。

onData(ObjectMatcher)
  .DataOptions
  .perform(ViewAction)
  .check(ViewAssertion);

onData传入的是一个ObjectMather。首先假设ListView的Adapter中的Item的定义如下:

public static class Item {
    private final int value;
    public Item(int value) {
        this.value = value;
    }
    public String toString() {
        return String.valueOf(value);
    }
}

下面定义一个withValue()的方法,返回一个BoundedMatcher。而其中的matchesSafely()方法是用来判断match与否的,判断的逻辑实现都放在这里。

public static Matcher<Object> withValue(final int value) {
    return new BoundedMatcher<Object,
            MainActivity.Item>(MainActivity.Item.class) {
        @Override public void describeTo(Description description) {
            description.appendText("has value " + value);
        }
        @Override public boolean matchesSafely(
                MainActivity.Item item) {
            return item.toString().equals(String.valueOf(value));
        }
    };
}

有了上面的铺垫,测试用例写起来就水到渠成了。在id是R.id.listAdapterView中找到数据项是27,然后执行click()操作。

@Test
public void clickItem() {
    onData(withValue(27))
            .inAdapterView(withId(R.id.list))
            .perform(click());
    //Do the assertion here.
}

最后需要注意的是,onData()并不适用于RecyclerView,因为它不是继承自AdapterView。Espresso提供专门给RecyclerView使用的RecyclerViewActions

@Test 
public void clickItem() {
    onView(withId(R.id.recycler_view))
            .perform(
                    RecyclerViewActions.actionOnItemAtPosition(27, click()));
}

3.2 Idling Resource的使用

应用开发中很常见的一个场景是,点击某个按钮,发起网络请求,等请求回来后解析数据,更新界面。Espresso针对这种测试场景,提供了原生的支持。

假设被测Activity初始化后有一个耗时的数据加载过程,activity.isSyncFinished()方法判断数据加载是否已经完成。代码如下:

@Override
protected void onCreate(Bundle savedInstanceState) {
    //模拟耗时的数据加载
    new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
        @Override
        public void run() {
            mIsSyncFinished = true;
        }
    }, 5000);
}

private volatile boolean mIsSyncFinished = false;
public boolean isSyncFinished() {
    return mIsSyncFinished;
}

这种情况,Espresso提供了IdlingResource来保证数据加载完成了才开始执行测试用例代码。首先,需实现IdlingResource接口:

  • getName()方法返回的String是作为注册回调的Key,所以要确保唯一性
  • registerIdleTransitionCallback()的参数ResourceCallback会用做isIdleNow()时候的回调
  • isIdleNow()是否已经处于空闲状态,这里调用activity.isSyncFinished()方法来判断数据加载是否完成

private static class MyIdlingResource implements IdlingResource {
    private ResourceCallback mCallback = null;
    private MainActivity mActivity;

    MyIdlingResource(MainActivity activity) {
        mActivity = activity;
    }

    @Override
    public String getName() {
        return "MyIdlingResource";
    }

    @Override
    public void registerIdleTransitionCallback(ResourceCallback callback) {
        mCallback = callback;
    }

    @Override
    public boolean isIdleNow() {
        boolean isIdle = mActivity != null && mActivity.isSyncFinished();
        if (isIdle && mCallback != null) {
            mCallback.onTransitionToIdle();
        }
        return isIdle;
    }
}

MyIdlingResource需要在恰当的时机注册和反注册。@Before@After是依照JUnit4的惯例,分别在用例执行之前和之后去注册和反注册。那么,如下测试用例执行的过程是:

  1. 测试用例启动,注册MyIdlingResource
  2. 启动被测Activity
  3. Activity初始化,启动数据加载过程
  4. Activity数据加载完成,执行测试用例方法testTextViewDisplay()
  5. 测试用例结束,反注册MyIdlingResource

可见,IdlingResource能够保证流转到Idle状态,才会执行测试代码:

@Test
public void testTextViewDisplay() {
    onView(withText("Show SnackBar")).check(ViewAssertions.matches(isDisplayed()));
}

@Before
public void registerIntentServiceIdlingResource() {
    Activity activity = mActivityRule.getActivity();
    idlingResource = new MyIdlingResource((MainActivity) activity);
    Espresso.registerIdlingResources(idlingResource);
}

@After
public void unregisterIntentServiceIdlingResource() {
    Espresso.unregisterIdlingResources(idlingResource);
}

3.3. 执行原理

本文开头提到Espresso其中一个特点,无需主动写Sleep等待UI事件的执行和UI的绘制。原因是,Espresso的用例运行过程是只有当UI线程IDLE和UI队列没有需要执行的事件时,Espresso的测试代码才会被执行。使用方无需写Sleep逻辑等待UI绘制完成。以下是Espresso测试用例执行简易的流程图,帮助理解:

写在最后

引用官方介绍的一段话,Espresso的目标受众是开发者。希望更多的团队能够实现Google的期许最大化利用Espresso,把Bug扼杀在摇篮中。

Target Audience

Espresso is targeted at developers, who believe that automated testing is an integral part of the development lifecycle. While it can be used for black-box testing, Espresso’s full power is unlocked by those who are familiar with the codebase under test.

引用

Getting Started With Espresso 2.0:https://www.youtube.com/watch?v=TGU0B4qRlHY

Advanced Android Espresso:https://realm.io/news/chiu-ki-chan-advanced-android-espresso-testing/

Android Espresso 测试框架探究:http://blog.csdn.net/weijianfeng1990912/article/details/51540468

Android自动化测试-AdapterView的测试:https://segmentfault.com/a/1190000004392396

Android单元测试研究与实践:http://tech.meituan.com/Android_unit_test.html

文章来自: QQ音乐技术团队 公众号

原创声明,本文系作者授权云+社区-专栏发表,未经许可,不得转载。

如有侵权,请联系 yunjia_community@tencent.com 删除。

编辑于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏葡萄城控件技术团队

扩展GridView控件——为内容项添加拖放及分组功能

引言 相信大家对GridView都不陌生,是非常有用的控件,用于平铺有序的显示多个内容项。打开任何WinRT应用或者是微软合作商的网站,都会在APP中发现Gri...

2695
来自专栏郭耀华‘s Blog

Android中级教程之----Log详解(Log.v,Log.d,Log.i,Log.w,Log.e)

在Android群里,经常会有人问我,Android Log是怎么用的,今天我就把从网上以及SDK里东拼西凑过来,让大家先一睹为快,希望对大家入门Androi...

34110
来自专栏Android开发经验

自适应软键盘的Dialog以及监听软键盘弹起

1613
来自专栏Android干货园

Android ListView性能优化,异步加载图片

版权声明:本文为博主原创文章,转载请标明出处。 https://blog.csdn.net/lyhhj/article/details/48...

992
来自专栏偏前端工程师的驿站

动手写个数字输入框3:痛点——输入法是个魔鬼

前言  最近在用Polymer封装纯数字的输入框,开发过程中发现不是坑,也有不少值得研究的地方。本系列打算分4篇来叙述这段可歌可泣的踩坑经历: 《动手写个数字输...

1986
来自专栏腾讯Bugly的专栏

​ 《企鹅电竞weex实践—— iOS SDK的小九九》

| 导语 企鹅电竞iOS端在3.2版本接入了Weex,感受了一把前端的代码原生的体验。本文从WeexSDK源码出发,主要介绍了Weex在iOS侧的框架结构以及大...

4105
来自专栏Golang语言社区

打造专属自己的html5拼图小游戏

利用canvas切出小块图片 我们知道现在的拼图游戏都是由九张小图片依次排列组成的,就是类似九宫格那样。那么以前的做法就是我们利用Photoshop这样的工具把...

3846
来自专栏韦弦的微信小程序

微信小程序导航参数中含有问号

和三一样,还可以使用 encodeURIComponent 和 decodeURIComponent 这就是小程序中导航的参数含有?的解决方案,如果还有其他好...

802
来自专栏Windows Community

Windows Community Toolkit 4.0 - DataGrid - Overview

Windows Community Toolkit 4.0 于 2018 月 8 月初发布:Windows Community Toolkit 4.0 Rele...

582
来自专栏写写代码吃吃瓜

Android自带抽屉布局及NavigationView的使用

1542

扫码关注云+社区