পরীক্ষা অ্যানিমেশন

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

অ্যানিমেশন পরীক্ষা অপ্টিমাইজ করুন

উচ্চ-মানের অ্যানিমেশন পরীক্ষা করার সময়, প্রায়শই অটো-অ্যাডভান্স নিষ্ক্রিয় করে মধ্যবর্তী UI অবস্থা যাচাই করার জন্য ম্যানুয়ালি ফ্রেমগুলো পরীক্ষা করার প্রয়োজন হয়। এই নির্দিষ্ট ফ্রেম-বাই-ফ্রেম লুপগুলোর জন্য, আপনার অ্যাসারশনগুলো কার্যকর করতে runWithoutImplicitWait মেথডটি ব্যবহার করুন। সাধারণ নোড কোয়েরিগুলো (যেমন onNodeWithTag বা fetchSemanticsNode ) এমন কিছু অন্তর্নিহিত সিঙ্ক্রোনাইজেশন চালু করে যা ঘড়ি ম্যানুয়ালি নিয়ন্ত্রণ করার সময় অপ্রয়োজনীয় হয়ে পড়ে, তাই এগুলোকে এড়িয়ে গেলে আপনার টেস্ট রানটাইম উল্লেখযোগ্যভাবে দ্রুত হয়।

ব্যবহারের নির্দেশিকা

  • ম্যানুয়াল ক্লক ম্যানেজমেন্ট : যখন mainClock.autoAdvance মান false সেট করা থাকে এবং বর্তমান ফ্রেমের জন্য UI একটি জ্ঞাত ও স্থিতিশীল অবস্থায় থাকে, তখন এই API-টি ব্যবহার করুন।
  • UI থ্রেড এক্সিকিউশন : UI ট্রি-এর স্থিতিশীলতা নিশ্চিত করতে, UI থ্রেডে runWithoutImplicitWait কল করুন, যেমন runOnUiThread ব্যবহার করে। UI থ্রেডের বাইরে এটি চালালে আপনার টেস্ট রেস কন্ডিশন এবং স্টেল স্টেট রিডের ঝুঁকিতে পড়ে।
  • শুধুমাত্র পঠনযোগ্য অ্যাসারশন : ব্লকটিতে কঠোরভাবে শুধুমাত্র পঠনযোগ্য অ্যাসারশন থাকতে হবে। স্টেট পরিবর্তনকারী যেকোনো কাজ এই ব্লকের বাইরে সম্পাদন করা উচিত।

উদাহরণ 

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

{% হুবহু %} {% endverbatim %} {% হুবহু %} {% endverbatim %}
পূর্ববর্তী
অ্যানিমেশন কাস্টমাইজ করুন
পরবর্তী
টুলস