ไลบรารีการทดสอบ Health Connect (androidx.health.connect:connect-testing
) ช่วยให้คุณสร้างการทดสอบอัตโนมัติได้ง่ายขึ้น คุณสามารถใช้ไลบรารีนี้เพื่อยืนย��นลักษณะการทํางานของแอปพลิเคชันและตรวจสอบว่าแอปพลิเคชันตอบสนองต่อกรณีที่เกิดขึ้นไม่บ่อยซึ่งทดสอบด้วยตนเองได้ยากอย่างถูกต้อง
คุณสามารถใช้ไลบรารีเพื่อสร้างการทดสอบ 1 หน่วยในเครื่อง ซึ่งโดยทั่วไปจะยืนยันลักษณะการทํางานของคลาสในแอปที่โต้ตอบกับไคลเอ็นต์ Health Connect
หากต้องการเริ่มใช้ไลบรารี ให้เพิ่มไลบรารีดังกล่าวเป็นทรัพยากร Dependency ทดสอบ ดังนี้
testImplementation("androidx.health.connect:connect-testing:1.0.0-alpha01")
จุดแรกเข้าของห้องสมุดคือชั้นเรียน FakeHealthConnectClient
ซึ่งคุณ
ใช้ในการทดสอบเพื่อแทนที่ HealthConnectClient
FakeHealthConnectClient
มีฟีเจอร์ดังต่อไปนี้
- การนําเสนอระเบียนในหน่วยความจําเพื่อให้คุณแทรก นําออก ลบ และอ่านได้
- การสร้างโทเค็นการเปลี่ยนแปลงและการติดตามการเปลี่ยนแปลง
- การแบ่งหน้าสำหรับระเบียนและการเปลี่ยนแปลง
- ระบบรองรับคำตอบการรวมด้วยต้นขั้ว
- อนุญาตให้ฟังก์ชันใดก็ได้แสดงข้อยกเว้น
FakePermissionController
ที่สามารถใช้เพื่อจำลองการตรวจสอบสิทธิ์
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการแทนที่ทรัพยากร Dependency ในการทดสอบ โปรดอ่าน การแทรกทรัพยากร Dependency ใน Android ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลจำลองได้ที่หัวข้อการใช้ Test Doubles ใน Android
ตัวอย่างเช่น หากคลาสที่โต้ตอบกับไคลเอ็นต์มีชื่อว่า HealthConnectManager
และใช้ HealthConnectClient
เป็น Dependency คลาสดังกล่าวจะมีลักษณะดังนี้
class HealthConnectManager(
private val healthConnectClient: HealthConnectClient,
...
) { }
ในการทดสอบ คุณสามารถส่����่า����ลองไปยังคลาสที่ทดสอบแทนได้ ดังนี้
import androidx.health.connect.client.testing.ExperimentalTestingApi
import androidx.health.connect.client.testing.FakeHealthConnectClient
import kotlinx.coroutines.test.runTest
@OptIn(ExperimentalTestingApi::class)
class HealthConnectManagerTest {
@Test
fun readRecords_filterByActivity() = runTest {
// Create a Fake with 2 running records.
val fake = FakeHealthConnectClient()
fake.insertRecords(listOf(fakeRunRecord1, fakeBikeRecord1))
// Create a manager that depends on the fake.
val manager = HealthConnectManager(fake)
// Read running records only.
val runningRecords = manager.fetchReport(activity = Running)
// Verify that the records were filtered correctly.
assertTrue(runningRecords.size == 1)
}
}
การทดสอบนี้ยืนยันว่าฟังก์ชัน fetchReport
จําลองใน
HealthConnectManager
กรองระเบียนตามกิจกรรมอย่างถูกต้อง
การยืนยันข้อยกเว้น
การเรียกใช้ HealthConnectClient
เกือบทุกรายการอาจทำให้เกิดข้อยกเว้น ตัวอย่างเช่น
เอกสารประกอบสำหรับ insertRecords
พูดถึงข้อยกเว้นเหล่านี้
@throws android.os.RemoteException
สำหรับความล้มเหลวในการขนส่ง IPC@throws SecurityException
สำหรับคำขอที่มีการเข้าถึงที่ไม่ได้รับอนุญาต@throws java.io.IOException
สำหรับปัญหา I/O ของดิสก์
ข้อยกเว้นเหล่านี้ครอบคลุมกรณีต่างๆ เช่น การเชื่อมต่อไม่ดีหรืออุปกรณ์มีพื้นที่ว่างไม่เพียงพอ แอปของคุณต้องตอบสนองต่อปัญหารันไทม์เหล่านี้อย่างถูกต้องเนื่องจาก ก็เกิดขึ้นได้ทุกเมื่อ
import androidx.health.connect.client.testing.stubs.stub
@Test
fun addRecords_throwsRemoteException_errorIsExposed() {
// Create Fake that throws a RemoteException
// when insertRecords is called.
val fake = FakeHealthConnectClient()
fake.overrides.insertRecords = stub { throw RemoteException() }
// Create a manager that depends on the fake.
val manager = HealthConnectManager(fake)
// Insert a record.
manager.addRecords(fakeRunRecord1)
// Verify that the manager is exposing an error.
assertTrue(manager.errors.size == 1)
}
การรวม
การเรียกการรวมไม่มีการติดตั้งใช้งานปลอม แต่การเรียกใช้การรวมจะใช้สแต็บที่คุณตั้งโปรแกรมให้ทํางานในลักษณะหนึ่งๆ ได้ คุณสามารถเข้าถึงตัวอย่างข้อมูลผ่านพร็อพเพอร์ตี้ overrides
ของ FakeHealthConnectClient
ตัวอย่างเช่น คุณตั้งโปรแกรมฟังก์ชันการรวมให้แสดงผลการค้นหาที่เฉพาะเจาะจงได้ ดังนี้
import androidx.health.connect.client.testing.AggregationResult
import androidx.health.connect.client.records.HeartRateRecord
import androidx.health.connect.client.records.ExerciseSessionRecord
import java.time.Duration
@Test
fun aggregate() {
// Create a fake result.
val result =
AggregationResult(metrics =
buildMap {
put(HeartRateRecord.BPM_AVG, 74.0)
put(
ExerciseSessionRecord.EXERCISE_DURATION_TOTAL,
Duration.ofMinutes(30)
)
}
)
// Create a fake that always returns the fake
// result when aggregate() is called.
val fake = FakeHealthConnectClient()
fake.overrides.aggregate = stub(result)
จากนั้นคุณสามารถยืนยันว่าคลาสที่ทดสอบ HealthConnectManager
ในกรณีนี้ ประมวลผลผลลัพธ์อย่างถูกต้องโดยทำดังนี้
// Create a manager that depends on the fake.
val manager = HealthConnectManager(fake)
// Call the function that in turn calls aggregate on the client.
val report = manager.getHeartRateReport()
// Verify that the manager is exposing an error.
assertThat(report.bpmAverage).isEqualTo(74.0)
สิทธิ์
ไลบรารีการทดสอบมี FakePermissionController
ซึ่งสามารถส่งผ่าน
เป็นทรัพยากร Dependency ของ FakeHealthConnectClient
วัตถุของคุณที่อยู่ภายใต้การทดสอบสามารถใช้PermissionController���through
พร็อพเพอร์ตี้ permissionController
ของอินเทอร์เฟซ HealthConnectClient
เพื่อตรวจสอบ
เพื่อขอสิทธิ์ ซึ่งโดยปกติจะดำเนินการก่อนการโทรติดต่อลูกค้าทุกครั้ง
หากต้องการทดสอบฟังก์ชันนี้ คุณสามารถตั้งค่าสิทธิ์ที่ใช้ได้โดยใช้
FakePermissionController
:
import androidx.health.connect.client.testing.FakePermissionController
@Test
fun newRecords_noPermissions_errorIsExposed() {
// Create a permission controller with no permissions.
val permissionController = FakePermissionController(grantAll = false)
// Create a fake client with the permission controller.
val fake = FakeHealthConnectClient(permissionController = permissionController)
// Create a manager that depends on the fake.
val manager = HealthConnectManager(fake)
// Call addRecords so that the permission check is made.
manager.addRecords(fakeRunRecord1)
// Verify that the manager is exposing an error.
assertThat(manager.errors).hasSize(1)
}
การใส่เลขหน้า
การใส่เลขหน้าเป็นข้อบกพร่องที่พบได้บ่อยมาก ดังนั้น FakeHealthConnectClient
จะให้กลไกสำหรับช่วยคุณยืนยันว่าการใช้การแบ่งหน้าสำหรับ
ระเบียนและการเปลี่ยนแปลงจะทำงานอย่างถูกต้อง
เรื่องของคุณที่อยู่ในการทดสอบ HealthConnectManager
ในตัวอย่างของเราสามารถระบุ
ขนาดของหน้าใน ReadRecordsRequest
:
fun fetchRecordsReport(pageSize: Int = 1000) }
val pagedRequest =
ReadRecordsRequest(
timeRangeFilter = ...,
recordType = ...,
pageToken = page1.pageToken,
pageSize = pageSize,
)
val page = client.readRecords(pagedRequest)
...
การตั้งค่าขนาดหน้าเป็นค่าต่ำ เช่น 2 จะช่วยให้คุณทดสอบการแบ่งหน้าเ������ได้��ย่าง����า��ด��ย ตัวอย่างเช่น คุณสามารถแทรกระเบียน 5 รายการเพื่อให้ readRecords
แสดงผล 3 หน้าที่แตกต่างกัน ดังนี้
@Test
fun readRecords_multiplePages() = runTest {
// Create a Fake with 2 running records.
val fake = FakeHealthConnectClient()
fake.insertRecords(generateRunningRecords(5))
// Create a manager that depends on the fake.
val manager = HealthConnectManager(fake)
// Read records with a page size of 2.
val report = manager.generateReport(pageSize = 2)
// Verify that all the pages were processed correctly.
assertTrue(report.records.size == 5)
}
ข้อมูลการทดสอบ
ไลบรารีนี้ยังไม่มี API ในการสร้างข้อมูลจำลอง แต่คุณใช้ข้อมูลและเครื่องมือสร้างที่ไลบรารีใช้ได้ใน Android Code Search
ต้นกำเนิด
พร็อพเพอร์ตี้ overrides
ของ FakeHealthConnectClient
ช่วยให้คุณเขียนโปรแกรม (หรือสร้างสตับ) ฟังก์ชันใดก็ได้เพื่อให้แสดงข้อยกเว้นเมื่อเรียกใช้
การเรียกใช้การรวมข้อมูลยังแสดงผลข้อมูลตามต้องการได้ และรองรับการจัดคิวคำตอบหลายรายการ ดูข้อมูลเพิ่มเติมได้ที่ Stub
และ MutableStub
สรุปกรณีที่เป็นปัญหาที่สุด
- ตรวจสอบว่าแอปทำงานตามที่คาดไว้เมื่อลูกค้าส่งข้อยกเว้น โปรดดูเอกสารของแต่ละฟังก์ชัน��พื่อดูว่ามีข้อยกเว้นอะไรบ้าง ควรตรวจสอบ
- ยืนยันว่าทุกการโทรที่คุณเรียกหาลูกค้า มีการกำหนดไว้ว่า ตรวจสอบสิทธิ์
- ยืนยันการใช้การใส่เลขหน้า
- ตรวจสอบสิ่งที่จะเกิดขึ้นเมื่อคุณดึงข้อมูลหน้าเว็บหลายหน้า แต่มีหน้าเว็บหนึ่งที่มีโทเค็นหมดอายุ