在Robolectric2.2之前，大多数测试通过调用构造方法来直接创建activites（new MyActivity()）,然后手工调用生命周期方法比如onCreate()。一些shadowActivity的方法也被广泛的应用（shadowActivity.callOnCreate()）。

Robolectric的一个流式API ActivityController改变了这些糟糕的情况，它通过模拟android如何创建activity和通过他们的生命周期驱动来工作。ActivityController是一个在2.0推出但是现在需要在2.2使用的流式API。除了调用像onCreate()之外的方法，它确保activity的内部状态和生命周期是相符的。

What do I do now?

我们通常不会直接创建一个ActivityController，使用Robolectric.buildActivity()来得到。在你只是简单的需要一个初始化好的activity的最基本的测试中，你通常可以通过下面的方式来得到：

Activity activity=Robolectric.buildActivity(MyActivity.class).create().get();

这将会创建一个MyActivity的新对象，并且通过生命周期调用它的onCreate()方法。
想要验证在onResume()的时候发生的事情是在onCreate()之后没有发生的？可以用如下方法：

ActivityController controller = Robolectric.buildActivity(MyActivity.class).create().start();
Activity activity =controller.get();
//assert that something hasnt happend
activityController.resume();
//assert it happend!

类似的方法包括start(),pause(),stop(),destroy()。如果你想要测试完整的创建生命周期可以用下面的代码：

Activity activity = Robolectric.buildActivity(MyActivity.class).create().start().resume.visible().get();

你可以通过intent模拟启动一个activity

Intent intent = new Intent(Intent.ACTION_VIEW);
Activity activity = Robolectric.buildActivity(MyActivity.class).withIntent(intent).create().get();

或者恢复savedInstanceState

Bundle savedInstanceState=new Bundle();
Activity activity = Robolectric.buildActivity(MyActivity.class).create().restoreInstanceState(savedInstanceState).get();

如果测试中需要更多的方法，可以参考AcivityController的Java Docs

在上面的使用中有一个visible()方法，这个方法的意义是什么？
在真实的android app中，activity的view层是没有附着到window上的直到onCreate()被调用之后，在这些发生之前，activity的view不会被置为visible，这就意味着不能点击他们，在真机或者模拟器上activity的onPostResume()被调用之后才会附着到window上。
所以什么时候去调用visible()?当你需要在activity进行交互的时候，比如Robolectric.clickOn()方法需要view是visible状态并且功能完备，这种情况就需要在create()之后调用visible().

使用扩展模块

为了减少将要测试的应用的外部依赖数量，robolectric的shadows被分割成许多扩展包，Robolectric主模块仅仅提供了为基础androidsdk提供的shadows，对appcompat或者support library在扩展模块中提供，如下表所示：

Using Library Resources

当Robolectric运行一个test的时候，它试图去下载并且索引应用所有的资源，所以当调用assetManager的时候可以返回这些资源。对于三方库提供的资源，一些扩展性配置就是需要的。

Using Libraries with Gradle

如果你使用gradle构建你的项目，并且使用 ==RobolectricTestRunner== 来运行你的test，不需要额外的配置，这是因为android的gradle插件将会在构建的时候merge三方库资源和项目的资源文件。RobolectricGradleTestRunner在version3.1过期了。

UsingLibraries with Maven

如果你使用maven来构建项目，你将需要告诉Robolectric哪里的unpacked 资源是为你使用的哪一个库准备的，这个配置可以指定在@Config注解里：

@RunWith(RobolectricTestRunner.class)
@Config(libraries={
    "build/unpacked-libraries/library1",
    "build/unpacked-libraries/library2"
})
public class TestClass{
    
}

或者在robolectric.properties文件中指定：

libraries=build/unpacked-libraries/library1,build/unpacked-libraries/library2

所有路径相对于工程的根目录

Debugging Resource Loading Issues

如果你不能确信一个指定的库的资源是否已经下载完成，通过设置系统属性==robolectric.logging.enabled=true== 来打开debug日志然后再运行测试。你会看到一些输出如下：

loading resources for 'com.foo' from build/unpacked-libraries/library1...

如果你看不到一个指定的库在这个列表中，再次检查一下配置

Using Qualified Resources（限定资源）

在android developer docs 的描述中，资源限定符允许你根据设备的语言，屏幕尺寸，是否夜间等因素改变你的资源加载。当你要做出严谨的测试是乏味的（每个字符串都有所有支持的语言的翻译），你会发现你想要在不同的限定环境来运行测试。

Specifying Resources in Test

指定一个资源限定符很简单，通过在你的测试用例上或者测试类上使用@Config注解简单的添加想要的限定符，这取决于你是想要改变你整个文件还是单个测试的的资源限制。
给出如下资源values/strings.xml

<string name="not_overridden">Not Overridden</string>
<string name="overridden">Unqualified value</string>
<string name="overridden_twice">Unqualified value</string>

value-en/strings.xml

<string name="overridden">English qualified value</string>
<string name="overridden_twice">English qualified value</string>

values-en-port/strings.xml

<string name="overridden_twice">English portrait value</string>

下面使用android资源限定规则的Robolectric测试将会通过

@Test
@Config(qualifiers="en-port")
public void shouldUseEnglishAndPortraitResources(){
    final Context context = RuntimeEnvironment.application;
    assertThat(context.getString(R.id.not_overridden)).isEqualTo("Not Overridden");
    assertThat(context.getString(R.id.overridden)).isEqualTo("English     qualified value");
    assertThat(context.getString(R.id.overridden_twice)).isEqualTo("English portrait qualified value");
}

多种限定符需要用破折号分割开，在google限定符列表里可以找到对应的限定符