יש שלוש דרכים עיקריות לבצע אינטראקציה עם רכיבים בממשק המשתמש:
- כלי האיתור מאפשרים לבחור רכיב אחד או יותר (או צמתים) עץ סמנטיקה) כדי לטעון טענות נכונות או לבצע פעולות לגביהן.
- טענות נכוֹנוּת משמשות כדי לאמת שהרכיבים קיימים או שיש בהם .
- פעולות מחדירות אירועי משתמש מדומים ברכיבים, כמו קליקים או תנועות אחרות.
חלק מממשקי ה-API האלה מקבלים SemanticsMatcher
כדי להתייחס לאחד או יותר
צמתים בעץ הסמנטיקה.
גלאי
אפשר להשתמש ב-onNode
וב-onAllNodes
כדי לבחור צומת אחד או יותר.
בהתאמה, אבל אפשר גם להשתמש בכלי למציאת נוחות
חיפושים, כמו onNodeWithText
,
onNodeWithContentDescription
. אפשר לעיין ברשימה המלאה
תקציר לבדיקה
בחירת צומת יחיד
composeTestRule.onNode(<<SemanticsMatcher>>, useUnmergedTree = false): SemanticsNodeInteraction
// Example
composeTestRule
.onNode(hasText("Button")) // Equivalent to onNodeWithText("Button")
בחירת כמה צמתים
composeTestRule
.onAllNodes(<<SemanticsMatcher>>): SemanticsNodeInteractionCollection
// Example
composeTestRule
.onAllNodes(hasText("Button")) // Equivalent to onAllNodesWithText("Button")
עץ לא ממוזג
חלק מהצמתים ממזגים את פרטי הסמנטיקה של הצאצאים שלהם. לדוגמה, לחצן עם שני רכיבי טקסט ממזג את התוויות של רכיבי הטקסט:
MyButton {
Text("Hello")
Text("World")
}
בבדיקה, משתמשים ב-printToLog()
כדי להציג את עץ הסמנטיקה:
composeTestRule.onRoot().printToLog("TAG")
הקוד הזה מדפיס את הפלט הבא:
Node #1 at (...)px
|-Node #2 at (...)px
Role = 'Button'
Text = '[Hello, World]'
Actions = [OnClick, GetTextLayoutResult]
MergeDescendants = 'true'
אם אתם צריכים להתאים צומת של העץ לא ממוזג, אפשר להגדיר
useUnmergedTree
אל true
:
composeTestRule.onRoot(useUnmergedTree = true).printToLog("TAG")
הקוד הזה מדפיס את הפלט הבא:
Node #1 at (...)px
|-Node #2 at (...)px
OnClick = '...'
MergeDescendants = 'true'
|-Node #3 at (...)px
| Text = '[Hello]'
|-Node #5 at (83.0, 86.0, 191.0, 135.0)px
Text = '[World]'
הפרמטר useUnmergedTree
זמין לכל מי שמחפש. לדוגמה, כאן
נעשה בו שימוש בכלי onNodeWithText
.
composeTestRule
.onNodeWithText("World", useUnmergedTree = true).assertIsDisplayed()
הצהרות
כדי לבדוק טענות נכונות (assertions) באמצעות קריאה ל-assert()
במכשיר SemanticsNodeInteraction
שהוחזר על ידי מוצא עם התאמה אחת או יותר:
// Single matcher:
composeTestRule
.onNode(matcher)
.assert(hasText("Button")) // hasText is a SemanticsMatcher
// Multiple matchers can use and / or
composeTestRule
.onNode(matcher).assert(hasText("Button") or hasText("Button2"))
אפשר גם להשתמש בפונקציות נוחות לטענות הנכונות ביותר, כמו
assertExists
, assertIsDisplayed
ו-assertTextEquals
.
תוכלו לעיין ברשימה המלאה בתקציר לבדיקת הכתיבה.
יש גם פונקציות לבדיקת טענות נכונות (assertions) באוסף של צמתים:
// Check number of matched nodes
composeTestRule
.onAllNodesWithContentDescription("Beatle").assertCountEquals(4)
// At least one matches
composeTestRule
.onAllNodesWithContentDescription("Beatle").assertAny(hasTestTag("Drummer"))
// All of them match
composeTestRule
.onAllNodesWithContentDescription("Beatle").assertAll(hasClickAction())
פעולות
כדי להחדיר פעולה לצומת, מפעילים את הפונקציה perform…()
:
composeTestRule.onNode(...).performClick()
ריכזנו כאן כמה דוגמאות של פעולות:
performClick(),
performSemanticsAction(key),
performKeyPress(keyEvent),
performGesture { swipeLeft() }
אפשר לעיין ברשימה המלאה תקציר לבדיקה
התאמות
אפשר להשתמש במגוון התאמות כדי לבדוק את הכתיבה
התאמות היררכיות
התאמות היררכיות מאפשרות לכם לעלות או לרדת בעץ הסמנטיקה ולבצע התאמה.
fun hasParent(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnySibling(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnyAncestor(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnyDescendant(matcher: SemanticsMatcher): SemanticsMatcher
ריכזנו כאן כמה דוגמאות להתאמות האלה:
composeTestRule.onNode(hasParent(hasText("Button")))
.assertIsDisplayed()
סלקטורים
דרך חלופית ליצור בדיקות היא להשתמש בבוררים, שעשויים לגרום בדיקות קריאות יותר.
composeTestRule.onNode(hasTestTag("Players"))
.onChildren()
.filter(hasClickAction())
.assertCountEquals(4)
.onFirst()
.assert(hasText("John"))
תוכלו לעיין ברשימה המלאה בתקציר לבדיקת הכתיבה.
משאבים נוספים
- אפליקציות בדיקה ב-Android: הכלי העיקרי לבדיקת Android דף הנחיתה כולל מבט מקיף על העקרונות והטכניקות של הבדיקה.
- יסודות הבדיקה: מידע נוסף על המושגים המרכזיים של בדיקת אפליקציה ל-Android.
- בדיקות מקומיות: אפשר להריץ כמה בדיקות באופן מקומי, בתחנת עבודה משלך.
- בדיקות אינסטרומנטליות: זה טוב להריץ גם בדיקות אינסטרומנטליות. כלומר, בדיקות שמריצים באופן ישיר במכשיר.
- אינטגרציה רציפה (CI): אינטגרציה רציפה (CI) מאפשרת לשלב את הבדיקות בפריסה צינור עיבוד נתונים.
- בדיקה של גדלים שונים של מסכים: באמצעות כמה מכשירים רבים שזמינים למשתמשים, צריך לבדוק מסכים שונים בגדלים שונים.
- Espresso: מיועדת לשימוש שמבוסס על תצוגה עם ממשקי משתמש, הידע של אספרסו עדיין יכול לעזור בהיבטים מסוימים של 'פיתוח נייטיב' בדיקה.