Robolectric测试框架使用笔记

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));
    }

5. 注意事项（遇到的坑）

   • 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
   

   这样就可以了

参考的文章：
http://www.vogella.com/tutorials/Robolectric/article.html#shadow-objects
http://blog.csdn.net/weijianfeng1990912/article/details/51020423