Robolectric

开始单元测试之前还是要先了解TDD

中文版:TDD 已死?让我们再聊聊 TDD

英文版:Introduction to Test Driven Development (TDD)


Robolectric概述

Android的单元测试可以分为两部分:

Local unit tests:运行于本地JVM
Instrumented test:运行于真机或者模拟器

如果使用Local测试,需要保证测试过程中不会调用Android系统API,否则会抛出RuntimeException异常。
因为Local测试是直接跑在本机JVM的,而之所以我们能使用Android系统API,是因为编译的时候,我们依赖了一个名为“android.jar”的jar包,但是jar包里所有方法都是直接抛出了一个RuntimeException,是没有任何任何实现的,这只是Android为了我们能通过编译提供的一个Stub!

当APP运行在真实的Android系统的时候,由于类加载机制,会加载位于framework的具有真正实现的类。由于我们的Local是直接在PC上运行的,所以调用这些系统API便会出错。

那么问题来了,我们既要使用Local测试,但测试过程又难免遇到调用系统API那怎么办?其中一个方法就是mock objects,比如借助Mockito,另外一种方式就是使用Robolectric

Robolectric就是为解决这个问题而生的。它实现一套JVM能运行的Android代码,然后在unit test运行的时候去截取android相关的代码调用,然后转到他们的他们实现的Shadow代码去执行这个调用的过程。


根据官网教程配置使用即可


本文配置环境:

Android Studio 3.0 Beta 5
Gradle Warpper: gradle-4.1-all
Gradle 插件:gradle:3.0.0-beta5
Android SDK:25
Robolectric:3.4.2

配置过程异常:

1.1 unknown property 'includeAndroidResources:

testCompile "org.robolectric:robolectric:3.4.2"

android {
  testOptions {
    unitTests {
      includeAndroidResources = true
    }
  }
} 

==注意==

  • 若写成testCompile,则测试代码放在 test 文件夹中
  • 若写成androidTest,则测试代码放在 androidTest 文件夹中

按照官网如上配置后 报错,Gradle Sync Error:

Error:(22, 0) Could not set unknown property 'includeAndroidResources' for object of type com.android.build.gradle.internal.dsl.TestOptions$UnitTestOptions.
<a href="openFile:G:\android\Samples\Tests\robolectric\app\build.gradle">Open File</a>

未知的属性includeAndroidResources,gradle版本由3.0.0-alpha8修改至3.0.0-beta5解决问题。

参考自: 'includeAndroidResources' is not working in AS3.0 Beta 2

1.2 Cannot Resolve symbol RobolectricTestRunner

@RunWith(RobolectricTestRunner.class)
public class SandwichTest {
}

尝试写一个 Robolectric Test的时候提示:cannot resolve robolectrictestrunner
参考robolectric github例子,将gradle版本修改为3.0.0-beta3,下载失败时添加maven { url 'https://maven.google.com' }

完整配置,Project build.gradle:

repositories {
        maven {
            url 'https://maven.google.com'
        }
        jcenter()
    }

1.2.1

如果依然存在 Cannot Resolve symbol RobolectricTestRunner,并且测试类在src/androidTest 目录下,移至src/test目录下,参考自: cannot resolve symbol RobolectricTestRunner

1.3 java.lang.NullPointerException at sun.nio.fs.WindowsPathParser.parse

Error:Cause: java.lang.NullPointerException 
at sun.nio.fs.WindowsPathParser.parse(WindowsPathParser.java:98)

Clear Project --> Gradle sync后解决

参考自:gradle-error-upgrading-to-android-studio-3-0-beta-1

1.4 Cannot resolve method 'assertThat(android.content.Intent)

参考官方例子时,遇到Cannot resolve method 'assertThat(android.content.Intent)的问题,该assertThat不是junithamcrest库方法,而是Android AssertJAssertJ库,引入库即可。

testCompile 'org.assertj:assertj-core:1.7.1'

参考自:importing correct AssertThat method for Robolectric Test

1.5 java.lang.AssertionError: Expecting: <"Intent { cmp=*** } (Intent@4e96cb04)"> to be equal to: <"Intent { cmp=*** } (Intent@70ecf57b)"> but was not.

    @Test
    public void clickingLogin_shouldStartLoginActivity() {
        WelcomeActivity activity = Robolectric.setupActivity(WelcomeActivity.class);
        activity.findViewById(R.id.login).performClick();

        Intent expectedIntent = new Intent(activity, LoginActivity.class);
        AbstractObjectAssert<?, Intent> actual = assertThat(shadowOf(activity).getNextStartedActivity());
        actual.isEqualTo(expectedIntent);
    }

运行官网的例子时,test failed:

java.lang.AssertionError: 
Expecting:
 <"Intent { cmp=robolectirc.example.andrew.robolectric/.LoginActivity } (Intent@4e96cb04)">
to be equal to:
 <"Intent { cmp=robolectirc.example.andrew.robolectric/.LoginActivity } (Intent@70ecf57b)">
but was not.

很明显两个Intent值相同但是对象引用不同导致的异常。 已经提了Issue 等待回复。

改为使用Junit的assertEquals后测试通过:

    @Test
    public void clickingLogin_shouldStartLoginActivity() {
        WelcomeActivity activity = Robolectric.setupActivity(WelcomeActivity.class);
        activity.findViewById(R.id.login).performClick();

        // 期望意图
        Intent expectedIntent = new Intent(activity, LoginActivity.class);

        // 获取跳转的意图
        Intent actual = ShadowApplication.getInstance().getNextStartedActivity();

        // 假设一致
        assertEquals(expectedIntent.getComponent(), actual.getComponent());
    }

奇怪的是,robolectric github例子按照README.md,使用命令行gradlew test可以成功测试,但在IDEA中运行DeckardActivityTestRun Test却报错:

!!! JUnit version 3.8 or later expected: 

java.lang.RuntimeException: Stub!
    at junit.runner.BaseTestRunner.<init>(BaseTestRunner.java:5)
    at junit.textui.TestRunner.<init>(TestRunner.java:54)

DeckardEspressoTest 运行并且测试通过。


参考:

Android单元测试之Robolectric框架

用Robolectric来做Android unit testing

Android robolectric 入门

Robolectric使用教程

Android单元测试框架Robolectric3.0介绍(一)

importing correct AssertThat method for Robolectric Test

assertj-android

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,373评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,732评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,163评论 0 238
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,700评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,036评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,425评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,737评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,421评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,141评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,398评论 2 243
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,908评论 1 257
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,276评论 2 251
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,907评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,018评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,772评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,448评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,325评论 2 261

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,544评论 25 707
  • 前言 春节后,事情比较多,没太多写作灵感。之前在《App组件化与业务拆分那些事》说过要写一篇怎么Android怎么...
    键盘男阅读 4,563评论 14 22
  • 一.基本介绍 背景: 目前处于高速迭代开发中的Android项目往往需要除黑盒测试外更加可靠的质量保障,这正是单元...
    anmi7阅读 1,958评论 0 6
  • 有霾一日 早上起来,雾霾一片。从22楼望去,似乎到了仙境。朋友圈里各种吐槽。想到今天约了保洁打扫,把家里简单收拾了...
    漫素里阅读 222评论 0 3
  • 故地重游总会有些感伤。 曾经嬉戏、学习的地方被围上了栏杆,售票参观,游人请我帮忙给他们拍照,于是最熟悉的景致里面挤...
    踢车刘阅读 194评论 0 0