同步您的测试

Compose 测试默认与您的界面同步。当您使用 ComposeTestRule 调用断言或操作时，测试会提前同步，直到界面树处于空闲状态。

通常情况下，您无需执行任何操作。但是，您应该了解一些边缘情况。

测试同步时，您的 Compose 应用会使用虚拟时钟提前时间。这意味着 Compose 测试并非实时运行，因此它们可以尽可能快地通过。

但是，如果您不使用同步测试的方法，则不会发生重组，并且界面将显示为已暂停。

@Test
fun counterTest() {
    val myCounter = mutableStateOf(0) // State that can cause recompositions.
    var lastSeenValue = 0 // Used to track recompositions.
    composeTestRule.setContent {
        Text(myCounter.value.toString())
        lastSeenValue = myCounter.value
    }
    myCounter.value = 1 // The state changes, but there is no recomposition.

    // Fails because nothing triggered a recomposition.
    assertTrue(lastSeenValue == 1)

    // Passes because the assertion triggers recomposition.
    composeTestRule.onNodeWithText("1").assertExists()
}

请注意，此要求仅适用于 Compose 层次结构，而不适用于应用的其余部分。

停用自动同步

当您通过 ComposeTestRule（例如 assertExists()）调用断言或操作时，您的测试会与 Compose 界面同步。在某些情况下，您可能希望停止此同步并自行控制时钟。例如，您可以控制时间来在界面仍繁忙时截取动画的精确屏幕截图。要停用自动同步，请将 mainClock 中的 autoAdvance 属性设置为 false

composeTestRule.mainClock.autoAdvance = false

通常情况下，您会自行推进时间。您可以使用 advanceTimeByFrame() 精确地推进一帧，或使用 advanceTimeBy() 推进特定时长。

composeTestRule.mainClock.advanceTimeByFrame()
composeTestRule.mainClock.advanceTimeBy(milliseconds)

空闲资源

Compose 可以同步测试和界面，以便在空闲状态下完成所有操作和断言，并根据需要等待或推进时钟。但是，某些异步操作的结果会影响界面状态，这些操作可以在测试不知情的情况下在后台运行。

在测试中创建并注册这些空闲资源，以便在判断受测应用是繁忙还是空闲时将其考虑在内。除非您需要注册其他空闲资源（例如，如果您运行的后台作业未与 Espresso 或 Compose 同步），否则无需执行任何操作。

此 API 与 Espresso 的空闲资源非常相似，用于指示受测对象是空闲还是繁忙。使用 Compose 测试规则注册 IdlingResource 的实现。

composeTestRule.registerIdlingResource(idlingResource)
composeTestRule.unregisterIdlingResource(idlingResource)

手动同步

在某些情况下，您必须将 Compose 界面与测试的其他部分或您正在测试的应用同步。

waitForIdle() 函数会等待 Compose 处于空闲状态，但该函数取决于 autoAdvance 属性

composeTestRule.mainClock.autoAdvance = true // Default
composeTestRule.waitForIdle() // Advances the clock until Compose is idle.

composeTestRule.mainClock.autoAdvance = false
composeTestRule.waitForIdle() // Only waits for idling resources to become idle.

请注意，在这两种情况下，waitForIdle() 还会等待待处理的绘制和布局过程。

此外，您可以使用 advanceTimeUntil() 推进时钟，直到满足特定条件。

composeTestRule.mainClock.advanceTimeUntil(timeoutMs) { condition }

请注意，给定条件应检查可能受此时间影响的状态（它仅适用于 Compose 状态）。

等待条件

任何依赖于外部工作的条件（例如数据加载或 Android 的测量或绘制（即 Compose 外部的测量或绘制））都应使用更通用的概念，例如 waitUntil()

composeTestRule.waitUntil(timeoutMs) { condition }

您还可以使用任何waitUntil 辅助函数

composeTestRule.waitUntilAtLeastOneExists(matcher, timeoutMs)

composeTestRule.waitUntilDoesNotExist(matcher, timeoutMs)

composeTestRule.waitUntilExactlyOneExists(matcher, timeoutMs)

composeTestRule.waitUntilNodeCount(matcher, count, timeoutMs)