การทดสอบ API

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

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

API บางรายการยอมรับ SemanticsMatcher เพื่ออ้างอิงโหนดอย่างน้อย 1 รายการในต้นไม้ความหมาย

หมายเหตุ: การทดสอบ UI ของเครื่องมือเขียนข้อความแตกต่างจากการทดสอบ UI ที่อิงตามมุมมอง เครื่องมือทาง UI ที่อิงตามมุมมองจะกําหนดความหมายของมุมมองอย่างชัดเจน มุมมองจะครอบครองพื้นที่สี่เหลี่ยมผืนผ้าและมีพร็อพเพอร์ตี้ต่างๆ เช่น ตัวระบุ ตําแหน่ง ระยะขอบ และระยะห่าง ใน Compose คุณต้องใช้แนวทางที่แตกต่างออกไปในการจับคู่องค์ประกอบ UI เนื่องจากคอมโพสิเบิลบางรายการเท่านั้นที่แสดง UI ลงในลําดับชั้น UI

เครื่องมือค้นหา

คุณสามารถใช้ onNode และ onAllNodes เพื่อเลือกโหนดอย่างน้อย 1 โหนดตามลำดับ แต่คุณก็ใช้เครื่องมือค้นหาที่สะดวกสำหรับการค้นหาที่พบบ่อยที่สุดได้ด้วย เช่น 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")

โครงสร้างที่ยังไม่ได้ผสาน

บางโหนดผสานข้อมูลเชิงอรรถของโหนดย่อย เช่น ปุ่มที่มีองค์ประกอบข้อความ 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 คุณเรียกดูรายการทั้งหมดได้ในเคล็ดลับการทดสอบการเขียน

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

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

หมายเหตุ: คุณไม่สามารถต่อการดำเนินการภายในฟังก์ชันดำเนินการ แต่ให้perform…()โทรหลายครั้ง

แทน

ตัวอย่างการดำเนินการมีดังนี้

performClick(),
performSemanticsAction(key),
performKeyPress(keyEvent),
performGesture { swipeLeft() }

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

ตัวจับคู่

โปรแกรมจับคู่ที่หลากหลายพร้อมใช้งานสำหรับการทดสอบโค้ด 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"))

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

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

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