Robolectric测试框架使用笔记

时间:2024-10-07 14:37:26

1. 概述

Robolectric(http://robolectric.org/)是一款支持在桌面JVM模拟Android环境的测试框架,通过shadow包下的类来截取view、activity等类的调用,代替它们运行。举个例子说明一下,比如android里面有个类叫TextView,他们实现了一个类叫ShadowTextView。这个类基本上实现了TextView的所有公共接口,假设你在unit test里面写到String text = textView.getText().toString();。在这个unit test运行的时候,Robolectric会自动判断你调用了Android相关的代码textView.getText(),然后这个调用过程在底层截取了,转到ShadowTextView的getText实现。而ShadowTextView是真正实现了getText这个方法的,所以这个过程便可以正常执行。

除此之外,Robolectric还为shadow类额外提供了很多接口,可以读取对应的Android类的一些状态。

对于一些测试对象依赖度较高而需要解除依赖的场景,可以借助mock框架。

对于网络请求还可以进行网络请求测试。

2. 配置

在module 的build.gradle中添加测试依赖:

dependencies {
testCompile 'junit:junit:4.12'
testCompile "org.robolectric:robolectric:3.3.2"
testCompile 'org.robolectric:shadows-httpclient:3.3.2'
}

3. 基本用法汇总

  1. 创建测试类

  2. 在类的前面添加:

    @RunWith(RobolectricTestRunner.class):指定Junit的构建程序为RobolectricTestRunner

    @Config(constants=BuildConfig.class,sdk=21):为每个类或测试的基础上添加配置设置。

    可以设置sdk版本,buildConfig、manifest等。

    @RunWith(RobolectricTestRunner.class)
    @Config(constants = BuildConfig.class, sdk=21)
    public class BrowseTest { @Before
    public void before(){
    ...
    } @Test
    public void test()throws Exception{
    ...
    }
    }
  3. 具体事例地址:

    https://github.com/robolectric/robolectric-samples

    google官方的一个例子

  4. 网络访问

  • 利用Robolectric进行测试,可以使用框架自带的FakeHttp,该功能可以模拟网络访问,也可以真实访问网络。

  • 访问真实网络

@Test
public void requestTest() throws Exception {
//设置是否拦截真实的请求。若不设置则默认为TRUE,若设false,则会真实访问网络。
FakeHttp.getFakeHttpLayer().interceptHttpRequests(false);
String url="https://api.douban.com/v2/movie/celebrity/1054395";
URL url1=new URL(url);
HttpURLConnection connection= (HttpURLConnection) url1.openConnection();
InputStream inputStream = connection.getInputStream();
BufferedReader reader=new BufferedReader(new InputStreamReader(inputStream));
String result=new String(reader.readLine().getBytes(),"UTF-8");
System.out.println(result);
}
  • 模拟网络访问
@Test
public void fakeRequestTest() throws IOException {
//设置拦截真实请求
FakeHttp.getFakeHttpLayer().interceptHttpRequests(true);
//模拟返回
ProtocolVersion version=new ProtocolVersion("HTTP",1,1);
HttpResponse httpResponse=new BasicHttpResponse(version,400,"OK");
//设置默认返回,所有请求返回这个
FakeHttp.setDefaultHttpResponse(httpResponse);
//添加一个返回规则,指定一个请求的期望返回
FakeHttp.addHttpResponseRule("http://www.baidu.com",httpResponse);
//执行请求
HttpGet get=new HttpGet("http://www.baidu.com");
HttpResponse response=new DefaultHttpClient().execute(get); //若response==httpResponse则通过。
Assert.assertThat(response,is(httpResponse));
}
  1. 注意事项(遇到的坑)

    • volley框架不返回结果

      由于volley一般是将结果回调到UI线程进行处理的,但是Robolectric对Ui线程的模拟支持似乎不太好,所以会导致能运行但是没结果的现象。
    final CountDownLatch latch = new CountDownLatch(1);
    
    //设置是否拦截真实的请求。若不设置则默认为TRUE,若设false,则会真实访问网络。
    FakeHttp.getFakeHttpLayer().interceptHttpRequests(false);
    String url="https://api.douban.com/v2/movie/celebrity/1054395";
    StringRequest req=new StringRequest(Request.Method.GET, url,
    new Response.Listener<String>() {
    @Override
    public void onResponse(String response) {
    System.out.println(response);
    latch.countDown();
    }
    },
    new Response.ErrorListener() {
    @Override
    public void onErrorResponse(VolleyError error) { }
    }
    );
    HttpStack stack=new HurlStack();
    Network network=new BasicNetwork(stack);
    ResponseDelivery responseDelivery=new ExecutorDelivery(Executors.newSingleThreadExecutor());
    RequestQueue queue=new RequestQueue(new NoCache(),network,4,responseDelivery);
    queue.start();
    queue.add(req);
    • 运行测试用例返回以下错误:
        java.lang.VerifyError: Expecting a stackmap frame at branch target 45
    Exception Details:
    Location:
    com/umeng/message/NotificationProxyBroadcastReceiver.a(Landroid/content/Context;)V @13: ifnonnull
    Reason:
    Expected stackmap frame at this location.
    Bytecode:
    0x0000000: 2bb6 0027 2bb6 0028 b600 2e4d 2cc7 0020
    0x0000010: b200 21bb 001e 59b7 003d 120c b600 3e2b
    0x0000020: b600 28b6 003e b600 3fb8 002f b12c 01b6
    0x0000030: 002d 572c 1205 b600 2a57 2b2c b600 29b2
    0x0000040: 0021 bb00 1e59 b700 3d12 0db6 003e 2bb6
    0x0000050: 0028 b600 3eb6 003f b800 30b1 at java.lang.Class.getDeclaredConstructors0(Native Method)
    at java.lang.Class.privateGetDeclaredConstructors(Class.java:2671)
    at java.lang.Class.getConstructor0(Class.java:3075)
    at java.lang.Class.getDeclaredConstructor(Class.java:2178)
    at org.robolectric.util.ReflectionHelpers.callConstructor(ReflectionHelpers.java:319)
    at org.robolectric.internal.bytecode.ShadowImpl.newInstanceOf(ShadowImpl.java:20)
    at org.robolectric.shadow.api.Shadow.newInstanceOf(Shadow.java:35)
    at org.robolectric.shadows.ShadowApplication.registerBroadcastReceivers(ShadowApplication.java:138)
    at org.robolectric.shadows.ShadowApplication.bind(ShadowApplication.java:127)
    at org.robolectric.shadows.CoreShadowsAdapter.bind(CoreShadowsAdapter.java:71)
    at org.robolectric.android.internal.ParallelUniverse.setUpApplicationState(ParallelUniverse.java:107)
    at org.robolectric.RobolectricTestRunner.beforeTest(RobolectricTestRunner.java:290)
    at org.robolectric.internal.SandboxTestRunner$2.evaluate(SandboxTestRunner.java:203)
    at org.robolectric.internal.SandboxTestRunner.runChild(SandboxTestRunner.java:109)
    at org.robolectric.internal.SandboxTestRunner.runChild(SandboxTestRunner.java:36)
    at org.junit.runners.ParentRunner$3.run(ParentRunner.java:290)
    at org.junit.runners.ParentRunner$1.schedule(ParentRunner.java:71)
    at org.junit.runners.ParentRunner.runChildren(ParentRunner.java:288)
    at org.junit.runners.ParentRunner.access$000(ParentRunner.java:58)
    at org.junit.runners.ParentRunner$2.evaluate(ParentRunner.java:268)
    at org.robolectric.internal.SandboxTestRunner$1.evaluate(SandboxTestRunner.java:63)
    at org.junit.runners.ParentRunner.run(ParentRunner.java:363)
    at org.junit.runner.JUnitCore.run(JUnitCore.java:137)
    at com.intellij.junit4.JUnit4IdeaTestRunner.startRunnerWithArgs(JUnit4IdeaTestRunner.java:117)
    at com.intellij.junit4.JUnit4IdeaTestRunner.startRunnerWithArgs(JUnit4IdeaTestRunner.java:42)
    at com.intellij.rt.execution.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:262)
    at com.intellij.rt.execution.junit.JUnitStarter.main(JUnitStarter.java:84)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:498)
    at com.intellij.rt.execution.application.AppMain.main(AppMain.java:147)

    解决方案:

    https://github.com/robolectric/robolectric-gradle-plugin/issues/144#issuecomment-189561165

    打开菜单Run->Edit Configuration

    按照以下设置: 在VM option中添加-ea -noverify

    Robolectric测试框架使用笔记

    这样就可以了

参考的文章:

http://www.vogella.com/tutorials/Robolectric/article.html#shadow-objects

http://blog.****.net/weijianfeng1990912/article/details/51020423