[Espresso 4 Android Doc] 9. ATSL

声明：本系列文章是对 Android Testing Support Library官方文档的翻译，水平有限，欢迎批评指正。

1. Espresso 概览
2. Espresso 设置说明
3. Espresso 基础
4. Espresso 备忘录
5. Espresso 意图
6. Espresso 高级示例
7. Espresso Web
8. AndroidJUnitRunner
9. ATSL 中的 JUnit4 规则
10. UI Automator
11. 可访问性检查

我们在 Android 测试支持库中提供了一套供 AndroidJUnitRunner 使用的 JUnit 规则。JUnit 规则提供了更多的灵活性，并且减少了测试需要的样板代码。

​为了拥抱 ActivityTestRule 和 ServiceTestRule​，我们不再使用 ​​ActivityInstruentationTestCase2​ 和 ServiceTestCase 类型的 TestCase 。

ActivityTestRule

此规则提供了针对单个 activity 的功能测试。待测 activity 将在每个带 @Test 注解的测试和每个带 ​@Before​ 注解的方法执行前被启动。它将在测试结束并且所有带 ​@After​ 注解的方法执行完后被销毁。待测 activity 在测试期间可以通过调用 ​ActivityTestRule#getActivity​ 访问。

@RunWith(AndroidJUnit4.class)
@LargeTest
public class MyClassTest {

    @Rule
    public ActivityTestRule<MyClass> mActivityRule = new ActivityTestRule(MyClass.class);

    @Test
    public void myClassMethod_ReturnsTrue() { ... }
}

ServiceTestRule

此规则提供了在测试前后启动和终止服务的简单机制。它也会保证当启动（或绑定）一个服务时，该服务被成功的连接。服务可以使用它的一个帮助方法来启动（或绑定)。它将在测试结束并且所有带 ​@After​ 注解的方法执行完后自动被停止（或解绑）。

注意：此规则不适用于 ​IntentService​，因为它会在 ​IntentService#onHandleIntent(android.content.Intent)​ 结束了所有外发指令时自动销毁。所以无法保证及时建立一个成功的连接。

@RunWith(AndroidJUnit4.class)
@MediumTest
public class MyServiceTest {

    @Rule
    public final ServiceTestRule mServiceRule = new ServiceTestRule();

    @Test
    public void testWithStartedService() {
        mServiceRule.startService(
            new Intent(InstrumentationRegistry.getTargetContext(), MyService.class));
        // test code
    }

    @Test
    public void testWithBoundService() {
        IBinder binder = mServiceRule.bindService(
            new Intent(InstrumentationRegistry.getTargetContext(), MyService.class));
        MyService service = ((MyService.LocalBinder) binder).getService();
        assertTrue("True wasn't returned", service.doSomethingToReturnTrue());
    }
}