Kiểm thử bố cục Compose

Kiểm thử giao diện người dùng của ứng dụng để xác minh hành vi của mã Compose là chính xác. Việc này giúp bạn sớm phát hiện lỗi và cải thiện chất lượng ứng dụng.

Compose cung cấp một bộ API kiểm thử để tìm phần tử, xác minh thuộc tính của các phần tử đó và thực hiện các thao tác của người dùng. Các API này cũng bao gồm các tính năng nâng cao như thao tác với thời gian. Hãy sử dụng các API này để tạo các chương trình kiểm thử mạnh mẽ nhằm xác minh hành vi của ứng dụng.

trung bình

Nếu bạn đang làm việc với các thành phần hiển thị thay vì Compose, hãy xem phần Kiểm thử ứng dụng trên Android chung.

Đặc biệt, bạn nên bắt đầu tham khảo hướng dẫn Tự động hoá quy trình kiểm thử giao diện người dùng. Hướng dẫn này trình bày cách tự động hoá các chương trình kiểm thử chạy trên thiết bị, bao gồm cả khi sử dụng khung hiển thị.

Khái niệm chính

Sau đây là một số khái niệm chính để kiểm thử mã Compose.

  • Ngữ nghĩa: Kiểm thử Compose tương tác với giao diện người dùng bằng cách sử dụng ngữ nghĩa, cung cấp ý nghĩa cho các phần của giao diện người dùng và được tạo cùng với hệ phân cấp giao diện người dùng.
  • API Kiểm thử: Compose cung cấp các API kiểm thử để tìm kiếm phần tử, đưa ra nhận định về trạng thái và thuộc tính của các phần tử đó, cũng như thực hiện các thao tác để mô phỏng hoạt động tương tác của người dùng.
  • Đồng bộ hoá: Theo mặc định, các quy trình kiểm thử Compose sẽ tự động đồng bộ hoá với giao diện người dùng, chờ cho giao diện người dùng ở trạng thái rảnh trước khi đưa ra câu nhận định hoặc thực hiện hành động.
  • Khả năng tương tác: Trong các ứng dụng kết hợp, chương trình kiểm thử có thể tương tác liền mạch với cả phần tử Compose và thành phần dựa trên Khung hiển thị, đồng thời tích hợp với các khung kiểm thử khác.

Bản tóm tắt về kiểm thử

Hãy xem bản tóm tắt về kiểm thử để biết thông tin tổng quan về tất cả các chủ đề chính mà bạn nên tìm hiểu về việc kiểm thử trong Compose.

Thiết lập

Thiết lập ứng dụng để có thể kiểm thử mã Compose.

Trước tiên, hãy thêm các phần phụ thuộc sau vào tệp build.gradle của mô-đun chứa các quy trình kiểm thử giao diện người dùng của bạn:

// Test rules and transitive dependencies:
androidTestImplementation("androidx.compose.ui:ui-test-junit4:$compose_version")
// Needed for createComposeRule(), but not for createAndroidComposeRule<YourActivity>():
debugImplementation("androidx.compose.ui:ui-test-manifest:$compose_version")

Mô-đun này bao gồm ComposeTestRule và một phương thức triển khai cho Android có tên là AndroidComposeTestRule. Thông qua quy tắc này, bạn có thể thiết lập nội dung Compose hoặc truy cập vào hoạt động. Bạn tạo quy tắc bằng các hàm factory, createComposeRule hoặc createAndroidComposeRule nếu cần truy cập vào một hoạt động. Một quy trình kiểm thử giao diện người dùng điển hình cho Compose có dạng như sau:

// file: app/src/androidTest/java/com/package/MyComposeTest.kt

class MyComposeTest {

    @get:Rule val composeTestRule = createComposeRule()
    // use createAndroidComposeRule<YourActivity>() if you need access to
    // an activity

    @Test
    fun myTest() {
        // Start the app
        composeTestRule.setContent {
            MyAppTheme {
                MainScreen(uiState = fakeUiState, /*...*/)
            }
        }

        composeTestRule.onNodeWithText("Continue").performClick()

        composeTestRule.onNodeWithText("Welcome").assertIsDisplayed()
    }
}

Tài nguyên khác

  • Kiểm thử ứng dụng trên Android: Trang đích kiểm thử ứng dụng chính trên Android cung cấp cái nhìn bao quát hơn về các nguyên tắc và kỹ thuật kiểm thử cơ bản.
  • Nguyên tắc cơ bản về kiểm thử: Tìm hiểu thêm về các khái niệm chính của việc kiểm thử ứng dụng Android.
  • Kiểm thử cục bộ: Bạn có thể chạy một số kiểm thử cục bộ trên máy trạm của riêng mình.
  • Kiểm thử đo lường: Bạn cũng nên chạy các kiểm thử đo lường. Tức là các chương trình kiểm thử chạy trực tiếp trên thiết bị.
  • Tích hợp liên tục: Tính năng tích hợp liên tục cho phép bạn tích hợp các hoạt động kiểm thử vào quy trình triển khai.
  • Kiểm thử nhiều kích thước màn hình: Với nhiều thiết bị được cung cấp cho người dùng, bạn nên kiểm thử nhiều kích thước màn hình.
  • Espresso: Mặc dù dành cho giao diện người dùng dựa trên Khung hiển thị, nhưng kiến thức về Espresso vẫn có thể hữu ích cho một số khía cạnh của kiểm thử Compose.

Lớp học lập trình

Để tìm hiểu thêm, hãy thử tham khảo lớp học lập trình Kiểm thử Jetpack Compose.

Mẫu