ซิงค์ข้อมูลการทดสอบของคุณ

เขียนการทดสอบจะซิงค์กับ UI ของคุณโดยค่าเริ่มต้น เมื่อคุณโทรหา การยืนยันหรือการดำเนินการด้วย ComposeTestRule ระบบจะซิงค์ข้อมูลการทดสอบ ล่วงหน้า รอจนกว่าโครงสร้าง UI จะไม่มีการใช้งาน

โดยปกติคุณไม่ต้องดำเนินการใดๆ แต่ก็มีบางกรณีที่อาจเป็นไปได้ยาก ที่คุณควรรู้

เมื่อการทดสอบซิงค์กัน แอป Compose จะได้รับการประมวลผลขั้นสูงในเวลาโดยใช้ นาฬิกาเสมือนจริง ซึ่งหมายความว่าการทดสอบการเขียนไม่ได้ทำงานแบบเรียลไทม์ ดังนั้นจึงสามารถผ่าน ให้เร็วที่สุดเท่าที่จะเป็นไปได้

อย่างไรก็ตาม หากคุณไม่ได้ใช้วิธีซิงโครไนซ์การทดสอบ ระบบจะไม่ การจัดองค์ประกอบใหม่จะเกิดขึ้นและ UI จะหยุดชั่วคราว

@Test
fun counterTest() {
    val myCounter = mutableStateOf(0) // State that can cause recompositions.
    var lastSeenValue = 0 // Used to track recompositions.
    composeTestRule.setContent {
        Text(myCounter.value.toString())
        lastSeenValue = myCounter.value
    }
    myCounter.value = 1 // The state changes, but there is no recomposition.

    // Fails because nothing triggered a recomposition.
    assertTrue(lastSeenValue == 1)

    // Passes because the assertion triggers recomposition.
    composeTestRule.onNodeWithText("1").assertExists()
}

โปรดทราบว่าข้อกำหนดนี้มีผลบังคับใช้กับลำดับชั้นของการเขียนเท่านั้น และไม่ได้มีผลกับ ที่เหลือในแอปด้วย

ปิดใช้งานการซิงค์อัตโนมัติ

เมื่อคุณเรียกใช้การยืนยันหรือการดำเนินการผ่าน ComposeTestRule เช่น assertExists() การทดสอบของคุณจะซิงค์กับ UI ของ Compose ในบางกรณี คุณอาจต้องการหยุดการซิงค์นี้ และควบคุมนาฬิกาด้วยตัวเอง สำหรับ เช่น คุณสามารถควบคุมเวลาในการจับภาพหน้าจอของภาพเคลื่อนไหวที่ถูกต้องแม่นยำ ซึ่ง UI จะยังคงไม่ว่าง หากต้องการปิดใช้การซิงค์อัตโนมัติ ตั้งค่าพร็อพเพอร์ตี้ autoAdvance ใน mainClock เป็น false:

composeTestRule.mainClock.autoAdvance = false

โดยทั่วไปแล้ว คุณจะต้องประหยัดเวลาด้วยตนเอง คุณสามารถเลื่อนไปได้ทีละ 1 ช่วงเท่านั้น เฟรมที่มี advanceTimeByFrame() หรือตามระยะเวลาที่กำหนดด้วย advanceTimeBy():

composeTestRule.mainClock.advanceTimeByFrame()
composeTestRule.mainClock.advanceTimeBy(milliseconds)

ทรัพยากรที่ไม่มีการใช้งาน

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

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

API นี้คล้ายกับ Idling Resources ของ Espresso เป็นอย่างมากเพื่อระบุว่า วัตถุที่อยู่ภายใต้การทดสอบไม่มีการใช้งานหรือไม่ว่าง ใช้กฎการทดสอบการเขียนเพื่อลงทะเบียน การติดตั้งใช้งาน IdlingResource

composeTestRule.registerIdlingResource(idlingResource)
composeTestRule.unregisterIdlingResource(idlingResource)

การซิงค์ด้วยตนเอง

ในบางกรณี คุณต้องซิงค์ UI ของ Compose กับส่วนอื่นๆ ของ หรือแอปที่คุณกำลังทดสอบ

ฟังก์ชัน waitForIdle() จะรอให้ไม่มีความเคลื่อนไหวในการเขียน แต่ฟังก์ชันนี้ ขึ้นอยู่กับพร็อพเพอร์ตี้ autoAdvance:

composeTestRule.mainClock.autoAdvance = true // Default
composeTestRule.waitForIdle() // Advances the clock until Compose is idle.

composeTestRule.mainClock.autoAdvance = false
composeTestRule.waitForIdle() // Only waits for idling resources to become idle.

โปรดทราบว่าในทั้งสองกรณี waitForIdle() จะรอการวาดและเลย์เอาต์ที่รอดำเนินการด้วย บัตร

นอกจากนี้ คุณยังปรับนาฬิกาไปข้างหน้าจนกว่าจะเป็นไปตามเงื่อนไขบางอย่างได้ด้วย advanceTimeUntil()

composeTestRule.mainClock.advanceTimeUntil(timeoutMs) { condition }

โปรดทราบว่าเงื่อนไขที่ระบุควรกำลังตรวจสอบสถานะที่อาจได้รับผลกระทบ ตามนาฬิกานี้ (ใช้งานได้กับสถานะการเขียนเท่านั้น)

รอเงื่อนไข

เงื่อนไขใดๆ ที่ขึ้นอยู่กับงานภายนอก เช่น การโหลดข้อมูลหรือ วัดหรือวาด (วัดหรือวาดภายนอกการเขียน) ควรใช้ แนวคิดทั่วไปเพิ่มเติม เช่น waitUntil()

composeTestRule.waitUntil(timeoutMs) { condition }

คุณยังสามารถใช้ ผู้ช่วย waitUntil:

composeTestRule.waitUntilAtLeastOneExists(matcher, timeoutMs)

composeTestRule.waitUntilDoesNotExist(matcher, timeoutMs)

composeTestRule.waitUntilExactlyOneExists(matcher, timeoutMs)

composeTestRule.waitUntilNodeCount(matcher, count, timeoutMs)

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

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