Kiểm thử đơn vị bằng Glance

API kiểm thử đơn vị Glance cho phép bạn kiểm thử mã Glance mà không cần tăng số lượt xem hoặc cần đến một trình tự động hoá giao diện người dùng. Ví dụ: API kiểm thử đơn vị cho phép bạn xác minh các điều kiện, chẳng hạn như liệu các phần tử có nằm trong danh sách hay không hoặc liệu các hộp đã được đánh dấu hay chưa, bằng cách sử dụng các đối tượng so khớp như hasContentDescriptionEqualTo hoặc isChecked.

API này có dung lượng nhẹ và yêu cầu ít bước thiết lập hơn, vì vậy, bạn có thể thực hiện quá trình phát triển dựa trên kiểm thử khi phát triển từng phần của tiện ích và sắp xếp chúng để cải thiện khả năng tái sử dụng mã.

Thiết lập

Các phần phụ thuộc cần thiết để sử dụng thư viện kiểm thử đơn vị được minh hoạ trong các ví dụ sau:

// Other Glance and Compose runtime dependencies.
...
testImplementation 'androidx.glance:glance-testing:1.1.1'
testImplementation 'androidx.glance:glance-appwidget-testing:1.1.1'
testImplementation 'org.robolectric:robolectric:4.11.1'
...
// You may include additional dependencies, such as Robolectric, if your test
// needs to set a LocalContext.

Cấu trúc kiểm thử

Sắp xếp các hàm có khả năng kết hợp bên ngoài lớp GlanceAppWidget để cho phép sử dụng lại mã và kiểm thử đơn vị. Giảm độ phức tạp của các đơn vị đang được kiểm thử càng nhiều càng tốt.

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)
    }
}

Đặt bối cảnh và kích thước cho kiểm thử

Nếu hàm có thể kết hợp của bạn đọc bối cảnh bằng phương thức LocalContext.current(), thì bạn phải đặt một bối cảnh bằng setContext(). Nếu không, bước này là không bắt buộc.

Bạn có thể sử dụng bất kỳ khung kiểm thử đơn vị Android nào dựa trên JVM, chẳng hạn như Robolectric, để cung cấp ngữ cảnh.

Nếu hàm có khả năng kết hợp của bạn truy cập vào LocalSize, hãy đặt kích thước dự kiến cho quy trình kiểm thử trước khi cung cấp một thành phần kết hợp trong quy trình kiểm thử. Kích thước mặc định là 349.dp x 455.dp, tương đương với một tiện ích 5x4 xuất hiện trên thiết bị Pixel 4 ở chế độ dọc.

• Nếu AppWidget của bạn dùng sizeMode == Single, bạn có thể đặt giá trị này thành minWidth và minHeight trong tệp info.xml của tiện ích.
• Nếu AppWidget của bạn sử dụng sizeMode == Exact, bạn có thể xác định kích thước cần kiểm thử theo cách tương tự như cách bạn xác định kích thước cho tiện ích và xác định kích thước ngang và dọc mà tiện ích có thể xuất hiện, đồng thời kiểm thử các kích thước đó.
• Nếu AppWidget của bạn sử dụng sizeMode == Responsive, bạn có thể đặt thuộc tính này thành một trong các kích thước trong danh sách mà bạn cung cấp khi chỉ định sizeMode.

Thời lượng mặc định cho thời gian chờ kiểm thử là 1 giây, nhưng bạn có thể truyền thời lượng tuỳ chỉnh làm đối số cho phương thức runGlanceAppWidgetUnitTest nếu cơ sở hạ tầng kiểm thử của bạn thực thi một thời gian chờ khác.

Để biết thêm thông tin và mã mẫu, hãy xem tài liệu tham khảo về runGlanceAppWidgetUnitTest.