Android Developer Roadmap: Viết Kiểm thử UI với Espresso – Đảm Bảo Chất Lượng Giao Diện Ứng Dụng Android

Tháng 11/2026, gần như mọi màn hình mới trên Android đều viết bằng Compose. Nhưng phần lớn tài liệu kiểm thử UI vẫn mở đầu bằng onView(withId(R.id.button)).perform(click()). Chạy đúng câu lệnh đó trên một màn hình Compose, bạn nhận về NoMatchingViewException — không phải vì bạn viết sai, mà vì Compose không tạo ra View nào để Espresso tìm.

Vấn đề không nằm ở Espresso. Nó nằm ở việc dùng sai công cụ cho sai loại UI. Bài này vạch ranh giới đó — Espresso cho View-based UI, Compose UI test cho Compose — rồi đi vào phần thực sự quyết định chất lượng test: đồng bộ hóa, semantics, test tag, điều hướng, screenshot và những nguyên nhân làm test đỏ ngẫu nhiên.

Cập nhật 2026: những gì đã đổi

  • Compose BOM 2026.09.00; ui-test-junit4 và ui-test-manifest đi theo BOM, hiện là 1.12.1. Khai báo BOM một lần, đừng pin version từng artifact test.
  • androidx.test Espresso 3.7.0, runner/core/rules 1.7.0, ext-junit 1.3.0. Espresso vẫn được phát hành cho View-based UI — nó không bị bỏ.
  • Navigation 3 1.2.1 đã stable, Navigation 2 (2.10.2) chỉ còn bảo trì. Cách test điều hướng vì thế cũng khác: back stack là state, không phải controller ẩn.
  • Screenshot testing: plugin độc lập com.android.compose.screenshot không còn được bảo trì; Google chuyển sang screenshot test trong AGP test suites (AGP 9.5 trở lên).

Kiểm thử UI với Espresso: vẫn đúng, nhưng chỉ cho View

Espresso xây trên ba nhóm API, và gần như mọi test là một chuỗi ghép từ chúng: ViewMatcher tìm View, ViewAction tác động, ViewAssertion kiểm tra trạng thái.

onView(withId(R.id.buttonGreet))   // tìm
    .perform(click())              // hành động
    .check(matches(isDisplayed())) // kiểm tra

Vài API đáng nhớ: matcher withId, withText, isDisplayed, isEnabled, hasDescendant; action click, typeText, scrollTo, closeSoftKeyboard; assertion matches, doesNotExist, isChecked. Với danh sách, espresso-contrib có RecyclerViewActions.actionOnItemAtPosition; click theo nội dung thường bền hơn theo vị trí.

ActivityScenarioRule và vòng đời

ActivityScenarioRule launch Activity trước mỗi test và đóng nó sau khi test xong, nên mỗi test bắt đầu từ trạng thái sạch. Khi cần tự điều khiển vòng đời — xoay màn hình, đẩy app xuống background rồi quay lại — dùng ActivityScenario.launch và gọi moveToState ngay trong test.

IdlingResource: chỉ khi không thể sửa production code

Espresso tự chờ main looper rảnh, nhưng không biết một coroutine đang gọi API hay Room đang đọc đĩa. CountingIdlingResource (artifact espresso-idling-resource) giải quyết việc đó: bọc increment() quanh lúc bắt đầu, decrement() khi xong, rồi đăng ký resource trong @Before và gỡ trong @After qua IdlingRegistry.

Đừng biến đây thành mặc định: expose StateFlow của ViewModel hoặc inject dispatcher/test double để test await được kết quả. Idling resource là cầu nối cho màn hình legacy, không phải kiến trúc test.

Compose UI test: semantics là hợp đồng

Compose không có cây View. Nó có cây semantics: mỗi composable đóng góp các thuộc tính mà accessibility và test cùng đọc — text, content description, role, trạng thái bật/tắt, test tag. Điểm này quan trọng: thứ test đọc cũng chính là thứ TalkBack đọc, nên một test viết đúng semantics có giá trị accessibility miễn phí.

// File: app/build.gradle.kts
dependencies {
    androidTestImplementation(platform("androidx.compose:compose-bom:2026.09.00"))
    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
    debugImplementation("androidx.compose.ui:ui-test-manifest")

    androidTestImplementation("androidx.test.ext:junit:1.3.0")
    androidTestImplementation("androidx.test:runner:1.7.0")
    androidTestImplementation("androidx.test:rules:1.7.0")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.7.0")
}

ui-test-manifest chỉ cần khi dùng createComposeRule(). Nếu test cần chạm vào Activity, dùng createAndroidComposeRule<ComponentActivity>() và bỏ dependency đó.

  • Tìm: onNodeWithText, onNodeWithTag, onNodeWithContentDescription, onAllNodesWithTag kèm onFirst()/onLast(). Matcher: hasText, hasTestTag, isEnabled, hasClickAction.
  • Tác động: performClick, performTextInput, performTextClearance, performScrollTo, performTouchInput { swipeUp() }.
  • Kiểm tra: assertIsDisplayed, assertExists, assertIsEnabled, assertTextEquals, assertContentDescriptionEquals, assertDoesNotExist.

Hai cái bẫy nằm ngay trong danh sách trên. Thứ nhất, assertIsDisplayed và assertExists không tương đương: node có trong cây semantics nhưng nằm ngoài viewport vẫn “exists”, test pass trong khi người dùng không thấy gì. Thứ hai, cây semantics được merge theo mặc định: text bên trong Button gộp vào node của Button, nên onNodeWithText("Gửi") vẫn tìm ra Button. Cần node con riêng thì truyền useUnmergedTree = true.

Về test tag: Modifier.testTag("...") không hiện với người dùng và không ảnh hưởng accessibility — đó chính là lý do nó tồn tại. Dùng tag cho phần tử không có text ổn định (icon, container, item trong list) và đặt hằng số trong một object để UI với test không lệch nhau. Đừng tag mọi thứ: tag trùng vai trò với text sẽ khiến test bám vào cấu trúc thay vì hành vi.

Cùng một màn hình: hai bài test

Màn hình ví dụ: một ô nhập tên, một nút “Gửi”, một dòng kết quả. Nút chỉ bật khi tên không rỗng; bấm nút thì hiện “Chào <tên>”.

Bản Compose

// File: app/src/main/kotlin/com/evotek/demo/greet/GreetScreen.kt
// import của Compose lược bớt cho gọn
object GreetTags {
    const val NAME = "greet.name"
    const val BUTTON = "greet.button"
    const val RESULT = "greet.result"
}

fun greetingFor(name: String): String = "Chào ${name.trim()}"

@Composable
fun GreetScreen() {
    var name by rememberSaveable { mutableStateOf("") }
    var greeting by rememberSaveable { mutableStateOf("") }

    Column(Modifier.padding(24.dp).fillMaxSize()) {
        OutlinedTextField(
            value = name,
            onValueChange = { name = it },
            label = { Text("Tên của bạn") },
            singleLine = true,
            modifier = Modifier.fillMaxWidth().testTag(GreetTags.NAME)
        )
        Spacer(Modifier.height(12.dp))
        Button(
            onClick = { greeting = greetingFor(name) },
            enabled = name.isNotBlank(),
            modifier = Modifier.testTag(GreetTags.BUTTON)
        ) { Text("Gửi") }
        Spacer(Modifier.height(24.dp))
        Text(text = greeting, modifier = Modifier.testTag(GreetTags.RESULT))
    }
}

Toàn bộ logic sinh chuỗi nằm trong hàm thuần greetingFor, nên nó được test bằng JUnit ở src/test; UI test chỉ kiểm tra phần dây nối. Đó là cách chia việc rẻ nhất giữa hai tầng test.

Bản View + Espresso

Layout XML dùng ba id: editName, buttonGreet, textGreeting; Activity gắn listener và set text. Test tương ứng:

// File: app/src/androidTest/kotlin/com/evotek/demo/greet/GreetEspressoTest.kt
@RunWith(AndroidJUnit4::class)
class GreetEspressoTest {

    @get:Rule
    val scenarioRule = ActivityScenarioRule(GreetActivity::class.java)

    @Test
    fun nhapTen_roiBamGui_hienLoiChao() {
        onView(withId(R.id.editName))
            .perform(typeText("Evotek"), closeSoftKeyboard())
        onView(withId(R.id.buttonGreet)).perform(click())

        onView(withId(R.id.textGreeting))
            .check(matches(isDisplayed()))
            .check(matches(withText("Chào Evotek")))
    }
}

Bản Compose test

// File: app/src/androidTest/kotlin/com/evotek/demo/greet/GreetScreenTest.kt
@RunWith(AndroidJUnit4::class)
class GreetScreenTest {

    @get:Rule
    val composeRule = createComposeRule()

    @Test
    fun nhapTen_roiBamGui_hienLoiChao() {
        composeRule.setContent { MaterialTheme { GreetScreen() } }

        composeRule.onNodeWithTag(GreetTags.BUTTON).assertIsNotEnabled()
        composeRule.onNodeWithTag(GreetTags.NAME).performTextInput("Evotek")
        composeRule.onNodeWithTag(GreetTags.BUTTON).assertIsEnabled().performClick()

        composeRule.onNodeWithTag(GreetTags.RESULT)
            .assertIsDisplayed()
            .assertTextEquals("Chào Evotek")
    }
}

Hai test kiểm tra cùng một hành vi nhưng không chia sẻ dòng code nào — bình thường, vì hai bộ API mô tả hai loại cây UI. Cái không nên làm là viết lại toàn bộ luồng nghiệp vụ lần thứ ba trong UI test: hãy để unit test lo logic, UI test chỉ xác nhận người dùng thấy và bấm được.

App đang migrate có màn hình hybrid (XML View chứa ComposeView)? Dùng createAndroidComposeRule cho phần Compose và Espresso.onView cho phần View trong cùng một test — cả hai cùng trỏ vào Activity đang chạy.

Đồng bộ hóa: nơi flaky sinh ra

Espresso chờ main looper và các IdlingResource đã đăng ký. Compose test rule chờ composition/layout idle và điều khiển một clock ảo cho animation. Cả hai đều không tự biết dữ liệu từ server đã về, nên với nguồn ngoài Compose bạn phải nói rõ điều kiện dừng:

composeRule.waitUntilExactlyOneExists(
    matcher = hasTestTag(GreetTags.RESULT),
    timeoutMillis = 5_000
)
composeRule.onNodeWithTag(GreetTags.RESULT).assertTextEquals("Chào Evotek")

mainClock.autoAdvance = false rồi advanceTimeBy(500) cho bạn kiểm soát thời gian khi UI có animation hoặc delay. Ngược lại, một animation vô hạn (shimmer, loading) có thể khiến rule chờ mãi và test timeout; cách xử lý là tắt auto-advance, hoặc đặt trạng thái tĩnh sau test tag riêng. Với coroutine, inject dispatcher qua constructor để test thay được — đừng dựa vào may mắn về thời điểm.

Điều hướng và state

Assert điều hướng bằng thứ người dùng thấy — màn hình đích và nội dung của nó — chứ không phải bằng id tài nguyên điều hướng. Assert currentDestination.id là test implementation detail: đổi graph là test đỏ dù hành vi không đổi.

Với Navigation 2, TestNavHostController (artifact navigation-testing) cho phép set graph và kiểm tra back stack. Với Navigation 3, back stack là state do bạn tạo: dựng NavDisplay quanh một back stack khởi tạo sẵn, bấm hành vi rồi assert màn hình mới; bấm back rồi assert màn hình cũ. Ít cơ chế hơn, ít thứ để mock hơn.

Về state, ba thứ đáng assert trong UI test: trạng thái bật/tắt của control, nội dung hiển thị sau hành động, và việc phần tử biến mất sau khi hoàn tất. Đừng assert biến private, số lần gọi repository, hay thứ tự callback — đó là việc của unit test với fake.

Screenshot testing: bổ sung, không thay thế

Test hành vi không bắt được lỗi thị giác: chữ bị cắt, padding lệch, contrast kém, layout vỡ ở font scale 1.3. Screenshot test render composable ra ảnh, so với ảnh reference, fail khi lệch pixel và xuất report HTML để xem diff. Nó chạy host-side, không cần emulator, nên rất hợp CI.

Năm 2026, đường đi chính thức là screenshot test trong AGP test suites với AGP 9.5+; plugin com.android.compose.screenshot độc lập (0.0.1-alpha16) vẫn chạy được nhưng không còn được bảo trì. Một lựa chọn khác là Roborazzi, chạy screenshot test trên JVM qua Robolectric, không cần thiết bị.

Giới hạn: ảnh reference phải tạo trên môi trường cố định vì phụ thuộc font và renderer; nội dung động (giờ, ảnh mạng) phải freeze. Nó cũng không kiểm tra logic — màn hình đẹp nhưng sai nghiệp vụ vẫn pass.

Local, instrumented, emulator hay máy thật

Test local chạy trên JVM từ src/test: nhanh, không cần thiết bị, phù hợp logic, ViewModel, mapper, và cả Android framework qua Robolectric. Test instrumented chạy trên thiết bị/emulator từ src/androidTest: chậm hơn nhưng đúng môi trường thật, là nơi Espresso và Compose test rule hoạt động. Screenshot test host-side đứng giữa hai tầng này về chi phí.

Tầng Chạy ở đâu Trả lời câu hỏi
Local (JVM) Máy dev/CI, vài giây Logic có đúng không?
Instrumented Emulator hoặc máy thật Người dùng có thao tác được không?
Screenshot Host-side, renderer cố định Giao diện có bị lệch không?

Emulator cho kết quả lặp lại tốt hơn và chạy được trên CI không có máy thật; máy thật cần cho GPU, cảm biến, haptics và những lỗi chỉ một OEM gặp. Đừng chọn một: chạy instrumented trên emulator trong CI, và một lượt trên máy thật hoặc Firebase Test Lab trước release.

Gradle Managed Devices biến emulator thành hạ tầng do Gradle quản lý: tạo, cấp snapshot, dọn dẹp, cache kết quả và chạy shard song song. Cấu hình trong app/build.gradle.kts:

// File: app/build.gradle.kts
android {
    testOptions {
        managedDevices {
            localDevices {
                create("pixel8api36") {
                    device = "Pixel 8"
                    apiLevel = 36
                    systemImageSource = "aosp"
                }
            }
            groups {
                create("phones") {
                    targetDevices.add(devices["pixel8api36"])
                }
            }
        }
    }
}

Chạy bằng gradlew pixel8api36DebugAndroidTest, hoặc gradlew phonesGroupDebugAndroidTest cho cả group. Trên CI không có GPU, thêm -Pandroid.testoptions.manageddevices.emulator.gpu=swiftshader_indirect; muốn chia nhỏ thời gian chạy thì đặt android.experimental.androidTest.numManagedDeviceShards. ATD (Automated Test Device) nhẹ hơn nhưng chỉ hỗ trợ một số API level và không dùng được cho screenshot test cần hardware rendering — đừng mặc định ATD cho mọi suite.

Sáu bẫy làm UI test vô dụng

Phần lớn test UI “flaky” không hỏng vì framework. Chúng hỏng vì một trong sáu lựa chọn dưới đây — và bẫy animation thì đáng đọc kèm bài Animations trong Android, vì cùng một animation vừa làm UI đẹp vừa làm test đỏ.

Bẫy Triệu chứng Cách sửa
Thread.sleep Pass trên máy nhanh, fail trên CI chậm Dùng IdlingResource, waitUntil, hoặc await state
Test implementation detail Đổi cấu trúc code là test đỏ, hành vi không đổi Assert thứ người dùng thấy; logic để unit test
Không có test tag Test vỡ khi đổi text, dịch ngôn ngữ, thêm phụ đề Tag cho icon/container; text cho nội dung người dùng
Chạy trên dữ liệu production Tài khoản bị khóa, dữ liệu thật bị sửa, test phụ thuộc mạng Backend giả (MockWebServer) hoặc fake repository qua DI
Animation không ổn định Fail ngẫu nhiên ở bước click/scroll Tắt animation trên device test, hoặc điều khiển mainClock
Bỏ qua semantics accessibility Không tìm được icon button, TalkBack đọc vô nghĩa Thêm contentDescription; assert bằng nó

Nhìn trước 2027

Screenshot test sẽ dịch hẳn vào AGP test suites và vào CI host-side, trong khi GMD cùng thiết bị remote trở thành cách chạy instrumented mặc định. Navigation 3 làm test điều hướng bớt phụ thuộc vào controller nội bộ. Nhưng công cụ đổi không xóa bẫy: test vẫn phải bám semantics, vẫn phải có nguồn dữ liệu xác định, và vẫn phải chạy nhanh đủ để người viết code không bỏ qua.

Checklist trước khi commit test UI

  • Mỗi test kiểm tra một hành vi, tên test mô tả hành vi đó bằng tiếng Việt hoặc tiếng Anh thống nhất trong repo.
  • Không có Thread.sleep; mọi điểm chờ đều là idling resource, waitUntil hoặc state có thể await.
  • Phần tử không có text ổn định đã có test tag; icon button đã có contentDescription.
  • Test chạy được trên máy khác và trên CI: không phụ thuộc dữ liệu production, không phụ thuộc thứ tự test.
  • Đã chạy ít nhất hai lần trên emulator API 36 để kiểm tra flaky trước khi merge.

Đọc tiếp

UI test chỉ đáng tin khi tầng dưới đã chắc: nếu bạn chưa có unit test cho ViewModel và logic thuần, đọc Kiểm thử đơn vị trong Android với JUnit. Nếu Compose vẫn mới với bạn, bài giới thiệu Jetpack Compose giải thích composition và state trước khi bạn viết test cho nó. Toàn bộ thứ tự học nằm ở Android Developer Roadmap.