测试您的服务

如果您正在将本地 Service 作为应用组件实施，则可以创建 工具化测试 来验证其行为是否正确。

AndroidX 测试 提供了一个 API，用于单独测试您的 Service 对象。 ServiceTestRule 类是一个 JUnit 4 规则，它会在您的单元测试方法运行之前启动您的服务，并在测试完成后关闭服务。如需详细了解 JUnit 4 规则，请参阅 JUnit 文档。

设置测试环境

在为服务构建集成测试之前，请确保如 为 AndroidX 测试设置项目 中所述，为您的项目配置工具化测试。

创建服务的集成测试

应将集成测试编写为 JUnit 4 测试类。如需详细了解如何创建 JUnit 4 测试类和使用 JUnit 4 断言方法，请参阅 创建工具化测试类。

使用 @Rule 注释在您的测试中创建一个 ServiceTestRule 实例。

Kotlin

@get:Rule
val serviceRule = ServiceTestRule()

Java

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

以下示例展示了如何为服务实施集成测试。测试方法 testWithBoundService() 验证应用是否成功绑定到本地服务，以及服务接口是否按预期工作。

Kotlin

@Test
@Throws(TimeoutException::class)
fun testWithBoundService() {
  // Create the service Intent.
  val serviceIntent = Intent(
      ApplicationProvider.getApplicationContext<Context>(),
      LocalService::class.java
  ).apply {
    // Data can be passed to the service via the Intent.
    putExtra(SEED_KEY, 42L)
  }

  // Bind the service and grab a reference to the binder.
  val binder: IBinder = serviceRule.bindService(serviceIntent)

  // Get the reference to the service, or you can call
  // public methods on the binder directly.
  val service: LocalService = (binder as LocalService.LocalBinder).getService()

  // Verify that the service is working correctly.
  assertThat(service.getRandomInt(), `is`(any(Int::class.java)))
}

Java

@Test
public void testWithBoundService() throws TimeoutException {
  // Create the service Intent.
  Intent serviceIntent =
      new Intent(ApplicationProvider.getApplicationContext(),
        LocalService.class);

  // Data can be passed to the service via the Intent.
  serviceIntent.putExtra(LocalService.SEED_KEY, 42L);

  // Bind the service and grab a reference to the binder.
  IBinder binder = serviceRule.bindService(serviceIntent);

  // Get the reference to the service, or you can call
  // public methods on the binder directly.
  LocalService service =
      ((LocalService.LocalBinder) binder).getService();

  // Verify that the service is working correctly.
  assertThat(service.getRandomInt()).isAssignableTo(Integer.class);
}

其他资源

要了解更多关于此主题的信息，请参阅以下附加资源。

示例