Тестовые анимации

Compose предлагает ComposeTestRule , позволяющий писать тесты для анимаций детерминированным образом с полным контролем над временем выполнения теста. Это позволяет проверять промежуточные значения анимации. Кроме того, тест может выполняться быстрее, чем фактическая продолжительность анимации.

ComposeTestRule предоставляет доступ к своим тестовым часам через mainClock . Вы можете установить свойство autoAdvance в значение false, чтобы управлять часами в коде теста. После запуска анимации, которую вы хотите протестировать, часы можно перевести вперед с помощью advanceTimeBy .

Следует отметить, что advanceTimeBy не сдвигает часы точно на указанную длительность. Вместо этого он округляет её до ближайшей длительности, которая является множителем длительности кадра.

@get:Rule
val rule = createComposeRule()

@Test
fun testAnimationWithClock() {
    // Pause animations
    rule.mainClock.autoAdvance = false
    var enabled by mutableStateOf(false)
    rule.setContent {
        val color by animateColorAsState(
            targetValue = if (enabled) Color.Red else Color.Green,
            animationSpec = tween(durationMillis = 250)
        )
        Box(Modifier.size(64.dp).background(color))
    }

    // Initiate the animation.
    enabled = true

    // Let the animation proceed.
    rule.mainClock.advanceTimeBy(50L)

    // Compare the result with the image showing the expected result.
    // `assertAgainGolden` needs to be implemented in your code.
    rule.onRoot().captureToImage().assertAgainstGolden()
}
AnimationTestingSnippets.kt

Оптимизировать тесты анимации

注意： runWithoutImplicitWait API 包含在 androidx.compose.ui:ui-test-junit4:1.12.0-alpha03+ 和 androidx.compose.ui:ui-test:1.12.0-alpha03+ 中。

测试高保真动画时，您通常需要停用自动前进功能，并手动逐帧浏览，以断言中间界面状态。对于这些特定的逐帧循环，请使用 runWithoutImplicitWait 方法来执行断言。当您手动控制时钟时，标准节点查询（例如 onNodeWithTag 或 fetchSemanticsNode）会触发冗余的隐式同步，因此绕过这些查询可以显著缩短测试运行时长。

注意： 此 API 是一项专门的性能优化，严格来说仅用于手动逐帧动画测试。它不适用于通用界面测试，并且在手动时钟推进循环之外不会提供有意义的性能改进。

使用指南

• 手动时钟管理：当 mainClock.autoAdvance 设置为 false 且界面处于当前帧的已知稳定状态时，请使用此 API。
• 界面线程执行：为确保界面树的稳定性，请在界面线程上调用 runWithoutImplicitWait，例如使用 runOnUiThread。在界面线程之外运行它会使您的测试面临竞态条件和过时的状态读取。
• 只读断言：相应代码块应严格包含只读断言。任何会改变状态的操作都应在此代码块之外执行。

示例

@Test
fun runWithoutImplicitWaitSample() = runComposeUiTest {
    setContent { MainScreen() }
    mainClock.autoAdvance = false

    // Trigger an animation
    onNodeWithText("Start Animation").performClick()

    // Step through the animation frame-by-frame
    while (hasPendingWork()) {
        mainClock.advanceTimeByFrame()
        waitForIdle()
        runOnUiThread {
            // Suppress implicit synchronization inside this block to avoid redundant
            // waits on each node query, making the frame assertions execute much faster.
            runWithoutImplicitWait {
                val box1 = onNodeWithTag("Box1").fetchSemanticsNode()
                val box2 = onNodeWithTag("Box2").fetchSemanticsNode()
                val box3 = onNodeWithTag("Box3").fetchSemanticsNode()

                // Assert the exact intermediate state of all three properties for this frame
                assert(box1.boundsInRoot.right <= box2.boundsInRoot.left)
                assert(box2.boundsInRoot.right <= box3.boundsInRoot.left)
            }
        }
    }
}
TestSyncSnippets.kt

{% verbatim %} {% endverbatim %}