การทดสอบ API

วิธีการหลักในการโต้ตอบกับองค์ประกอบ UI มีอยู่ 3 วิธีดังนี้

• เครื่องมือค้นหาจะช่วยให้คุณเลือกองค์ประกอบอย่างน้อย 1 รายการ (หรือโหนดในส่วน ต้นไม้ความหมาย) เพื่อยืนยันหรือดำเนินการกับสิ่งนั้น
• Assertions ใช้เพื่อยืนยันว่ามีเอลิเมนต์อยู่หรือมีคุณสมบัติ
• การดำเนินการจะแทรกเหตุการณ์ของผู้ใช้จำลองลงในองค์ประกอบ เช่น การคลิกหรือ ท่าทางสัมผัสอื่นๆ

API เหล่านี้บางรายการยอมรับ SemanticsMatcher เพื่ออ้างอิงถึงอย่างน้อย 1 รายการ โหนดในแผนผังความหมาย

ตัวค้นหา

คุณสามารถใช้ onNode และ onAllNodes เพื่อเลือกโหนดเดียวหรือหลายโหนดได้ ตามลำดับ แต่คุณยังสามารถใช้เครื่องมือค้นหาอย่างสะดวกสำหรับ การค้นหา เช่น onNodeWithText และ onNodeWithContentDescription คุณสามารถเรียกดูรายการทั้งหมดได้ใน ข้อมูลสรุปของ Compose เกี่ยวกับการทดสอบ

เลือกโหนดเดียว

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")

ต้นไม้ที่ไม่ได้รวม

บางโหนดจะรวมข้อมูลอรรถศาสตร์ของบุตรหลาน ตัวอย่างเช่น ที่มีองค์ประกอบข้อความ 2 รายการผสานป้ายกำกับขององค์ประกอบข้อความเข้าด้วยกัน

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

การยืนยัน

ตรวจสอบการยืนยันโดยโทรหา assert() ในSemanticsNodeInteraction แสดงผลโดยผู้ค้นหาที่มีการจับคู่ที่ตรงกันตั้งแต่ 1 รายการขึ้นไป:

// 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 คุณสามารถเรียกดูรายการทั้งหมดได้ในข้อมูลสรุปของการทดสอบ Compose

นอกจากนี้ยังมีฟังก์ชันสำหรับตรวจสอบการยืนยันในคอลเล็กชันของโหนดด้วย ดังนี้

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

คุณสามารถเรียกดูรายการทั้งหมดได้ใน ข้อมูลสรุปของ Compose เกี่ยวกับการทดสอบ

ตัวจับคู่

ตัวจับคู่ที่หลากหลายพร้อมสำหรับการทดสอบ Compose โค้ด

ตัวจับคู่ตามลำดับชั้น

ตัวจับคู่แบบลําดับชั้นจะให้คุณเพิ่มหรือลดต้นไม้เชิงอรรถศาสตร์และดำเนินการ ที่ตรงกัน

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"))

คุณสามารถเรียกดูรายการทั้งหมดได้ในข้อมูลสรุปของการทดสอบ Compose

แหล่งข้อมูลเพิ่มเติม

• ทดสอบแอปใน Android: การทดสอบหลักของ Android หน้า Landing Page ให้มุมมองที่กว้างขึ้นเกี่ยวกับพื้นฐานและเทคนิคของการทดสอบ
• พื้นฐานการทดสอบ: ดูข้อมูลเพิ่มเติม เกี่ยวกับแนวคิดหลักเบื้องหลังการทดสอบแอป Android
• การทดสอบในเครื่อง: คุณทำการทดสอบได้บางรายการ ภายในเวิร์กสเตชันของคุณเอง
• การทดสอบแบบมีเครื่องวัด: ดี เพื่อทำการทดสอบแบบมีเครื่องวัดด้วย กล่าวคือ การทดสอบที่ทำงานโดยตรง ในอุปกรณ์
• การผสานรวมอย่างต่อเนื่อง: การผสานรวมอย่างต่อเนื่องช่วยให้คุณผสานรวมการทดสอบเข้ากับการติดตั้งใช้งานได้ ไปป์ไลน์
• ทดสอบหน้าจอขนาดต่างๆ: ด้วย มีอุปกรณ์มากมายที่ผู้ใช้มี คุณควรทดสอบสำหรับหน้าจอแบบต่างๆ ขนาดต่างๆ
• Espresso: เหมาะสำหรับข้อมูลในมุมมอง UI, ความรู้เกี่ยวกับ Espresso ยังมีประโยชน์สำหรับ Compose ในบางแง่มุม การทดสอบ