如何在 Android Robolectric 测试中强制更改配置？

Question

我正在使用 robolectric 来使我的 Android 单元测试足够快而有用。我想测试我编写的代码在屏幕方向发生变化以模拟常见的现实世界用例时是否有效。

具体来说，我正在测试的是对服务器的异步 http 调用，并在获取结果后解析一些 xml。我对所有工作都进行了单元测试，但无法弄清楚如何模拟屏幕旋转。任何导致 Activity 重新创建自身的状态更改都可以，不一定是屏幕旋转。

使用模拟器的解决方案不是一个选项，因为我每分钟运行几次测试，并且它们必须在 2 秒内运行。如果可能的话，我也希望能与 roboguice 一起使用。

谢谢。

Answer 1

在 Robolectric 中调用 recreate（请注意，使用 Robolectric 时您不必担心较旧的 API 版本）非常接近模拟配置更改，但不一定会捕获您可能犯的所有错误。特别是它不会创建 Activity 的新实例（而且我很确定它不会“擦除”它），因此如果您忘记恢复 Activity 的成员字段，您的测试将无法捕获它。不过，它对于测试片段来说确实足够好（非保留片段被销毁并重新实例化）。

如果您在 Robolectric 测试中的 Activity 上调用 recreate，则会发生以下情况：

1. onSaveInstanceState
2. onPause
3. onStop
4. onDestroy
5. onCreate
6. onStart
7. onRestoreInstanceState
8. onResume

（我通过覆盖测试活动中的大多数生命周期方法并将日志语句放入其中发现了这一点）

您可以更接近一点使用如下代码进行实际配置更改：（

Bundle bundle = new Bundle();
activityController.saveInstanceState(bundle).pause().stop().destroy();
controller = Robolectric.buildActivity(YourActivity.class).create(bundle).start().restoreInstanceState(bundle).resume();
activity = controller.get();

此代码适用于 Robolectric 2.1 - 如果您使用的是 2.2 或更高版本，则可能需要在 之后调用 .visible() 。 resume())

使用上面的内容，您将看到以下事件发生：

1. onSaveInstanceState
2. onPause
3. onStop
4. onDestroy
5. Activity 实例化的新实例（所有后续调用均在此新实例上）
6. onCreate
7. onStart
8. onRestoreInstanceState
9. onResume
10. onPostResume

这仍然不是准确的匹配，但更接近于遇到实际配置更改时发生的情况。

我认为这可能是对由于内存不足而破坏活动时发生的情况的一个不错的模拟，因为与调用 recreate() 不同，我认为这不会保留对保留片段的引用。但我在这个领域的根基不稳固！

更新：

如果您的 Activity 是通过意图启动的，您可能需要添加对 withIntent 的调用，如下所示：

Robolectric.buildActivity(YourActivity.class).withIntent(intent).create(bundle) // and so on...

Answer 2

您正在针对哪个 Android API 级别进行编译？如果是 3.0 或更高版本，您可以尝试 Activity。重新创建（）。文档指出：

使用新实例重新创建此 Activity。这会导致与由于配置更改而创建 Activity 时的流程本质上相同的流程 - 当前实例将经历其生命周期到 onDestroy()，然后在其之后创建一个新实例。

不过我自己还没有尝试过。

Answer 3

我已经成功使用 ZoFreX 的答案，但是我想添加如何实际模拟旋转。我知道OP指定旋转不是绝对必须的，但标题暗示这应该包含在答案中，并且可以帮助最终迷失在这里的人。

基本上，在应用 ZoFrex 的解决方案之前设置活动的方向。或者用代码更简洁：

// toggle orientation
int currentOrientation = fragment.getActivity().getResources().getConfiguration().orientation;
boolean isPortraitOrUndefined = currentOrientation == Configuration.ORIENTATION_PORTRAIT || currentOrientation == Configuration.ORIENTATION_UNDEFINED;
int toOrientation = isPortraitOrUndefined ? Configuration.ORIENTATION_LANDSCAPE : Configuration.ORIENTATION_PORTRAIT;
Robolectric.application.getResources().getConfiguration().orientation = toOrientation;

// ZoFreX's solution
Bundle bundle = new Bundle();
activityController.saveInstanceState(bundle).pause().stop().destroy();
controller = Robolectric.buildActivity(YourActivity.class).create(bundle).start().restoreInstanceState(bundle).resume();
activity = controller.get();

请查看 ZoFreX 的解决方案，因为它包含此处未包含的其他信息。

Answer 4

Robolectric 的 ActivityController 类有一个configurationChange() 方法，可能可以处理这个问题。天哪，它甚至还有 javadoc 注释！ ：D