เขียนการทดสอบจะซิงค์กับ 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 ในบางแง่มุม การทดสอบ