Glance Unit Test API ช่วยให้คุณทดสอบโค้ด Glance ได้โดยไม่ต้องเพิ่มจำนวนมุมมองหรือต้องใช้ UI Automator ตัวอย่างเช่น API การทดสอบหน่วยช่วยให้คุณยืนยันเงื่อนไขได้ เช่น องค์ประกอบอยู่ในรายการหรือมีการเลือกช่องแล้วหรือไม่ โดยใช้ตัวจับคู่ เช่น hasContentDescriptionEqualTo หรือ isChecked
API นี้ใช้ง่ายและใช้การตั้งค่าน้อยกว่า คุณจึงดำเนินการพัฒนาแบบทดสอบขณะพัฒนาวิดเจ็ตแต่ละชิ้นและจัดระเบียบเพื่อปรับปรุงการใช้โค้ดซ้ำได้
ตั้งค่า
ทรัพยากร Dependency ที่จำเป็นสำหรับการใช้ไลบรารี ยูนิตเทสต์ จะแสดงอยู่ในตัวอย่างต่อไปนี้
// Other Glance and Compose runtime dependencies.
...
testImplementation 'androidx.glance:glance-testing:1.1.0'
testImplementation 'androidx.glance:glance-AppWidget-testing:1.1.0'
testImplementation 'org.robolectric:robolectric:4.11.1'
...
// You may include additional dependencies, such as Robolectric, if your test
// needs to set a LocalContext.
โครงสร้างการทดสอบ
จัดระเบียบฟังก์ชันที่ประกอบกันได้นอกคลาส GlanceAppWidget เพื่อเปิดใช้การใช้โค้ดซ้ำและการทดสอบหน่วย ลดความซับซ้อนของหน่วยทดสอบให้มากที่สุด
class MyGlanceComposableTest {
@Test
fun myNewsItemComposable_largeSize_hasAuthorAsSubtitle() = runGlanceAppWidgetUnitTest {
// Prepare inputs and state
setAppWidgetSize(100.dp, 100.dp)
// Set the composable under test
provideComposable {
MyNewsItemComposable(TEST_NEWS_ITEM)
}
// Perform assertions
onNode(hasTestTag("subTitle"))
.assertHasText(TEST_NEWS_ITEM.authorName)
}
}
กำหนดบริบทและขนาดสำหรับการทดสอบ
หากฟังก์ชันคอมโพสิเบิลอ่านบริบทโดยใช้เมธอด LocalContext.current() คุณจะต้องตั้งค่าบริบทโดยใช้เมธอด LocalContext.current()
หรือจะข้ามขั้นตอนนี้ก็ได้
คุณสามารถใช้เฟรมเวิร์กการทดสอบหน่วย Android ที่ใช้ JVM ใดก็ได้ เช่น Roboletric เพื่อระบุบริบท
หากฟังก์ชันคอมโพสิเบิลเข้าถึง LocalSize ให้ตั้งค่าขนาดที่ต้องการสำหรับการทดสอบก่อนที่จะระบุคอมโพสิเบิลในการทดสอบ ขนาดเริ่มต้นคือ 349.dp x 455.dp ซึ่งเทียบเท่ากับวิดเจ็ตขนาด 5x4 ที่แสดงในอุปกรณ์ Pixel 4 ในโหมดแนวตั้ง
- หาก AppWidget ใช้
sizeMode == Singleคุณสามารถตั้งค่าเป็นminWidthและminHeightในไฟล์info.xmlของวิดเจ็ต - หาก AppWidget ใช้
sizeMode == Exactคุณจะระบุขนาดที่จะทดสอบได้โดยใช้วิธีคล้ายกับที่กำหนดขนาดวิดเจ็ต รวมถึงระบุขนาดแนวนอนและแนวตั้งที่วิดเจ็ตอาจปรากฏและทดสอบขนาดเหล่านั้น - หาก AppWidget ใช้
sizeMode == Responsiveคุณสามารถตั้งค่านี้เป็นขนาดใดขนาดหนึ่งจากรายการที่คุณระบุเมื่อระบุsizeMode
ระยะเวลาเริ่มต้นสำหรับการหมดเวลาการทดสอบคือ 1 วินาที แต่คุณสามารถส่งระยะเวลาที่กำหนดเองเป็นอาร์กิวเมนต์ไปยังเมธอด runGlanceAppWidgetUnitTest ได้หากโครงสร้างพื้นฐานการทดสอบบังคับใช้การหมดเวลาที่ต่างกัน
ดูข้อมูลเพิ่มเติมและตัวอย่างโค้ดได้ที่เอกสารอ้างอิงสำหรับ
runGlanceAppWidgetUnitTest