3. 认识 IdlingResource 接口：isIdleNow、registerIdleTransitionCallback、getDebugMessage

IdlingResource 是 Espresso 与异步任务通信的核心契约。测试框架通过轮询该接口的三个方法来判断被测应用是否进入空闲状态。本章深入拆解每个方法的语义、调用时机与典型实现规律。

3.1 接口定义与三个核心方法

3.2 isIdleNow() —— 空闲判定闸门

这是整个接口中最频繁被调用的方法（每秒最多 10 次）。实现者必须保证：

• 方法执行不阻塞主线程（通常只用 AtomicBoolean 状态检查）。
• 返回 true 表示“当前没有正在进行的异步操作”。
• 返回 false 时，Espresso 会等待下次轮询。

// 典型实现：追踪 Compose 协程任务数
private val activeTaskCount = AtomicInteger(0)

override fun isIdleNow(): Boolean {
    return activeTaskCount.get() == 0
}

fun onTaskStarted() {
    activeTaskCount.incrementAndGet()
}

fun onTaskFinished() {
    activeTaskCount.decrementAndGet()
}

3.3 registerIdleTransitionCallback() —— 通知式门铃

该方法在资源注册时被 Espresso 调用一次，传入一个 ResourceCallback 实例。实现者必须持有一个对该回调的引用，并在资源变得空闲时主动调用 callback.onTransitionToIdle()。这可以显著减少轮询延迟。

private var idleCallback: ResourceCallback? = null

override fun registerIdleTransitionCallback(callback: ResourceCallback?) {
    idleCallback = callback
}

// 当后台任务完成时
fun onTaskCompleted() {
    if (activeTaskCount.decrementAndGet() == 0) {
        idleCallback?.onTransitionToIdle()
    }
}

3.4 getDebugMessage() —— 调试镜像

当测试超时或断言失败时，Espresso 会收集所有已注册 IdlingResource 的调试消息并输出到日志。此方法应返回人类可读的当前状态。例如：

override fun getDebugMessage(): String {
    val count = activeTaskCount.get()
    return "ComposeTaskIdlingResource: active tasks = $count, idle = ${count == 0}"
}

在测试日志中你会看到类似输出：

Waiting for IdlingResource: ComposeTaskIdlingResource
  debug message: ComposeTaskIdlingResource: active tasks = 2, idle = false

这能快速定位是哪个后台任务组未被释放。

3.5 三个方法的协作流程图

3.6 三方法实现清单（推荐范式）

3.7 与 Compose 后台任务的适配规律

当使用 ComposeIdlingResource 监控 Compose 协程时，三个方法的实现与普通 Android 异步任务基本一致，但需注意：

• isIdleNow() 应与 Compose 协程的 pendingModifications 计数绑定。
• registerIdleTransitionCallback 要在 Compose 的 SnapshotStateObserver 触发刷新后执行回调。
• getDebugMessage() 推荐输出当前 Compose 渲染队列深度。