תכתוב הצעות 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וממשק המשתמש נמצא במצב יציב ומוכר עבור המסגרת הנוכחית. - הרצה של שרשור UI: כדי להבטיח את היציבות של עץ ממשק המשתמש, צריך לקרוא ל-
runWithoutImplicitWaitבשרשור UI, למשל באמצעות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) } } } }
מומלץ בשבילכם
- הערה: טקסט הקישור מוצג כש-JavaScript מושבת
- בדיקת הפריסה של חלון הכתיבה
- שיקולים נוספים
- התאמה אישית של אנימציות