同步测试

默认情况下,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 或 写邮件。

此 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)

其他资源

  • 在 Android 平台上测试应用:Android 测试的主要着陆页可让您更全面地了解测试基础知识和技术。
  • 测试基础知识:详细了解测试 Android 应用背后的核心概念。
  • 本地测试:您可以运行一些测试 在您自己的工作站上运行
  • 插桩测试:适合 来运行插桩测试也就是说,直接在设备上运行的测试。
  • 持续集成:借助持续集成,您可以将测试集成到部署流水线中。
  • 测试不同的屏幕尺寸由于用户可用的设备众多,因此您应针对不同的屏幕尺寸进行测试。
  • Espresso:虽然 Espresso 适用于基于 View 的界面,但 Espresso 知识对于 Compose 测试的某些方面仍然很有帮助。