ממשקי API לבדיקה

יש שלוש דרכים עיקריות לבצע אינטראקציה עם רכיבים בממשק המשתמש:

  • כלי האיתור מאפשרים לבחור רכיב אחד או יותר (או צמתים) עץ סמנטיקה) כדי לטעון טענות נכונות או לבצע פעולות לגביהן.
  • טענות נכוֹנוּת משמשות כדי לאמת שהרכיבים קיימים או שיש בהם .
  • פעולות מחדירות אירועי משתמש מדומים ברכיבים, כמו קליקים או תנועות אחרות.

חלק מממשקי ה-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: מיועדת לשימוש שמבוסס על תצוגה עם ממשקי משתמש, הידע של אספרסו עדיין יכול לעזור בהיבטים מסוימים של 'פיתוח נייטיב' בדיקה.