تست انیمیشن ها

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()
}

بهینه‌سازی تست‌های انیمیشن

هنگام آزمایش انیمیشن‌های با کیفیت بالا، اغلب لازم است که قابلیت پیشروی خودکار را غیرفعال کنید و فریم‌ها را به صورت دستی طی کنید تا حالت‌های میانی رابط کاربری را تأیید کنید. برای این حلقه‌های خاص فریم به فریم، از متد runWithoutImplicitWait برای اجرای تأییدهای خود استفاده کنید. کوئری‌های استاندارد گره (مانند onNodeWithTag یا fetchSemanticsNode ) همگام‌سازی‌های ضمنی را فعال می‌کنند که هنگام کنترل دستی ساعت، اضافی هستند، بنابراین دور زدن آنها به طور قابل توجهی زمان اجرای تست شما را سرعت می‌بخشد.

دستورالعمل‌های استفاده

  • مدیریت دستی ساعت : از این API زمانی استفاده کنید که mainClock.autoAdvance روی false تنظیم شده باشد و رابط کاربری در حالت پایدار و شناخته‌شده‌ای برای فریم فعلی باشد.
  • اجرای نخ رابط کاربری : برای اطمینان از پایداری درخت رابط کاربری، تابع 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)
            }
        }
    }
}

{% کلمه به کلمه %} {% فعل کمکی %} {% کلمه به کلمه %} {% فعل کمکی %}
قبلی
سفارشی کردن انیمیشن ها
بعدی
ابزار