Robolectric — khái niệm, nguyên lý hoạt động và kiểm thử đơn vị Android

Robolectric là gì

Robolectric là một framework mã nguồn mở được tạo ra vào năm 2010 để tăng tốc kiểm thử ứng dụng Android. Thay vì chạy trên trình giả lập hoặc thiết bị, Robolectric cung cấp các triển khai shadow của các lớp Android SDK hoạt động trực tiếp trên Máy ảo Java (JVM). Điều này cho phép chạy hàng nghìn kiểm thử trong vài giây.

Vấn đề mà Robolectric giải quyết

Kiểm thử Android truyền thống yêu cầu chạy ứng dụng trên trình giả lập, mất 3–10 phút để xây dựng APK, cài đặt và khởi chạy. Robolectric loại bỏ bước này: kiểm thử được biên dịch như các kiểm thử Java/Kotlin thông thường và chạy qua JUnit. Điều này cung cấp vòng phản hồi trong vài giây thay vì vài phút.

Các phiên bản Android được hỗ trợ

Robolectric hỗ trợ tất cả các phiên bản Android từ API 16 (Android 4.1) đến bản phát hành ổn định mới nhất. Cho mỗi phiên bản, một tập hợp đối tượng shadow tương ứng được cung cấp để mô phỏng hành vi của phiên bản nền tảng cụ thể mà ứng dụng đang được kiểm thử.

Kiến trúc và đối tượng shadow

Kiến trúc của Robolectric dựa trên cơ chế chặn cuộc gọi thông qua thay thế trình nạp lớp (classloader). Khi một kiểm thử gọi phương thức Android SDK, Robolectric chặn cuộc gọi và chuyển hướng nó đến đối tượng shadow. Một đối tượng shadow là một lớp Java mô phỏng hành vi thực của một thành phần Android nhưng hoạt động mà không cần nền tảng gốc.

Cách shadows hoạt động

Các đối tượng shadow triển khai các phương thức chính của các lớp Android gốc. Ví dụ, ShadowTextView mô phỏng các phương thức như getText(), setText(), getCurrentTextColor() và các phương thức khác. Khi textView.setText("Xin chào") được gọi, shadow lưu chuỗi và trả về nó khi getText() được gọi. Điều này cách ly kiểm thử khỏi kết xuất thực và các dịch vụ hệ thống.

Phân cấp shadow

Robolectric hỗ trợ hơn 200 lớp shadow bao phủ các thành phần chính của Android SDK: Activity, Fragment, TextView, Button, RecyclerView, WebView, LocationManager, ConnectivityManager và nhiều thành phần khác. Các đối tượng shadow tuân theo cùng một hệ thống phân cấp kế thừa như các lớp Android gốc.

Cài đặt và cấu hình Robolectric

Để cài đặt Robolectric trong dự án Gradle, cần thêm phụ thuộc testImplementation "org.robolectric:robolectric:4.x". Cũng cần chỉ định cấu hình androidsdk trong tệp build.gradle và thêm độ phân giải android:testInstrumentationRunner. Không cần plugin kiểm thử Android để làm việc với Robolectric.

Cấu hình Gradle cơ bản

Sau khi thêm phụ thuộc, cần cấu hình thư mục cho tệp kê khai, tài nguyên và nội dung. Robolectric tự động tìm AndroidManifest.xml, nhưng có thể cần chỉ định đường dẫn thủ công qua chú thích @Config hoặc thuộc tính hệ thống. Đối với dự án đa mô-đun, cấu hình được đặt riêng cho từng mô-đun.

// build.gradle — cấu hình Robolectric
android {
    testOptions {
        unitTests.includeAndroidResources = true
        unitTests.all {
            systemProperty 'robolectric.dependency.dir',
                project.rootDir.absolutePath + '/build/intermediates'
        }
    }
}

dependencies {
    testImplementation 'org.robolectric:robolectric:4.13'
    testImplementation 'org.junit.jupiter:junit-jupiter:5.10.0'
}

Chú thích @Config

Chú thích @Config cho phép ghi đè các tham số kiểm thử: sdk (phiên bản API), manifest (đường dẫn đến tệp kê khai), qualifiers (cấu hình màn hình, ngôn ngữ). Điều này hữu ích để kiểm tra hành vi ứng dụng trên các phiên bản Android, hướng màn hình và bản địa hóa khác nhau.

Viết kiểm thử với Robolectric

Kiểm thử Robolectric được viết như các kiểm thử đơn vị thông thường với @RunWith(RobolectricTestRunner.class) cho JUnit 4 hoặc qua RobolectricExtension cho JUnit 5. ActivityController quản lý vòng đời Activity: create(), start(), resume(), pause(), stop(), destroy(). Điều này cho phép kiểm tra chi tiết từng chuyển đổi trạng thái.

Kiểm thử Activity

Để kiểm thử Activity, sử dụng ActivityController, đi qua tuần tự các giai đoạn vòng đời. Truy cập Activity qua controller.get(). Tất cả các thành phần giao diện đều có thể truy cập qua findViewById, như trong ứng dụng thực. Các đối tượng shadow cho phép kiểm tra văn bản, khả năng hiển thị, màu sắc và các thuộc tính giao diện khác.

@RunWith(RobolectricTestRunner.class)
@Config(sdk = BuildConfig.SDK_INT)
public class MainActivityTest {

    @Test
    public void testActivityDisplaysGreeting() {
        ActivityController<MainActivity> controller =
            Robolectric.buildActivity(MainActivity.class);
        controller.create().start().resume();

        MainActivity activity = controller.get();
        TextView greeting = activity.findViewById(R.id.greeting);
        ShadowTextView shadow = Shadows.shadowOf(greeting);

        assertEquals("Welcome!", shadow.getText());
    }
}

Kiểm thử intent và điều hướng

Robolectric chặn các cuộc gọi startActivity() và cho phép kiểm tra các intent đã gửi qua ShadowActivity. Điều này cho phép kiểm tra điều hướng: xác minh rằng khi nhấp vào nút, một Intent được gửi với Action, Data và tham số Extra chính xác.

@Test
public void testNavigationToDetails() {
    controller.create().start().resume();
    MainActivity activity = controller.get();

    activity.findViewById(R.id.detailsButton).performClick();

    ShadowActivity shadowActivity = Shadows.shadowOf(activity);
    Intent intent = shadowActivity.getNextStartedActivity();
    assertEquals(
        DetailsActivity.class.getName(),
        intent.getComponent().getClassName()
    );
}

Robolectric so với trình giả lập

Robolectric và trình giả lập giải quyết các nhiệm vụ khác nhau. Robolectric lý tưởng cho kiểm thử đơn vị nhanh, kiểm tra logic giao diện, thành phần nghiệp vụ và kho lưu trữ. Trình giả lập cần thiết cho kiểm thử công cụ, xác minh tích hợp với API, kiểm thử camera, cảm biến và hiệu suất.

Kiểm thử ViewModel và Repository

Robolectric rất phù hợp để kiểm thử ViewModel, Repository và UseCase — các thành phần sử dụng Android SDK nhưng không yêu cầu giao diện người dùng thực. ViewModel được kiểm thử qua kiểm thử JUnit thông thường với RobolectricExtension, trong khi các thành phần vòng đời (LiveData, StateFlow) hoạt động trong môi trường shadow mà không cần mock.

Kiểm thử LiveData

Robolectric hỗ trợ LiveData ngay lập tức: bạn có thể đăng ký LiveData trong kiểm thử, thay đổi trạng thái qua ViewModel và kiểm tra giá trị đã phát ra. Đối với các thao tác bất đồng bộ, sử dụng InstantTaskExecutorRule hoặc runBlocking cho coroutine. Điều này loại bỏ nhu cầu mock các thành phần kiến trúc.

@RunWith(RobolectricTestRunner::class)
@Config(sdk = [BuildConfig.SDK_INT])
class ProfileViewModelTest {

    private val repository = FakeUserRepository()
    private val viewModel = ProfileViewModel(repository)

    @Test
    fun `loading profile sets state to success`() = runBlocking {
        viewModel.loadProfile("user123")
        val state = viewModel.profileState.getOrAwaitValue()
        Assertions.assertTrue(state is UiState.Success)
    }
}

Đối tượng shadow tùy chỉnh

Nếu các đối tượng shadow tiêu chuẩn của Robolectric không bao phủ một lớp Android SDK cần thiết, bạn có thể tạo Shadow tùy chỉnh. Để làm điều này, tạo một lớp với chú thích @Implements(ClassName.class) và triển khai các phương thức cần thiết với @Implementation. Các shadow tùy chỉnh được đăng ký qua @Config(shadows = [CustomShadow::class]).

Kiểm thử ContentProvider và Resources

Robolectric hỗ trợ kiểm thử ContentProvider qua Robolectric.buildContentProvider(). Bạn có thể kiểm tra các thao tác CRUD, truy vấn với so khớp URI và xử lý quyền truy cập. Tài nguyên (chuỗi, màu sắc, kích thước) cũng có thể truy cập qua RuntimeEnvironment.application.resources, cho phép kiểm thử mã phụ thuộc vào tài nguyên.

Di chuyển từ trình giả lập sang Robolectric

Chuyển đổi từ kiểm thử công cụ sang Robolectric đòi hỏi thay đổi cách tiếp cận. Kiểm thử công cụ (AndroidJUnit4) xác minh hành vi thực trên trình giả lập, trong khi Robolectric xác minh logic cô lập trong môi trường shadow. Nên bao phủ logic nghiệp vụ bằng kiểm thử Robolectric và giữ kiểm thử công cụ cho các kịch bản tích hợp.

Thích ứng kiểm thử hiện có

Khi di chuyển, cần: thay thế AndroidJUnit4 bằng RobolectricTestRunner, thêm @Config với phiên bản SDK mục tiêu, thay thế ActivityTestRule bằng ActivityController và di chuyển phụ thuộc từ androidTestImplementation sang testImplementation. Các mock (MockK, Mockito) hoạt động với Robolectric mà không cần thay đổi — chúng độc lập với nền tảng.

Hạn chế khi di chuyển

Robolectric không hỗ trợ: kiểm thử camera (CameraX), NFC, Bluetooth, sinh trắc học, làm việc với tệp thực và thư viện gốc. Các kịch bản này cần kiểm thử công cụ trên trình giả lập. Robolectric cũng không tái tạo kết xuất thực — kiểm thử bố cục tốt hơn nên thực hiện qua Compose Test Rule hoặc Espresso. Tuy nhiên, để xác minh logic nghiệp vụ, điều hướng và trạng thái ViewModel, Robolectric thay thế hoàn toàn trình giả lập với tốc độ nhanh hơn 10 lần.

Tương thích với phiên bản Java và Kotlin

Robolectric yêu cầu JDK 11 trở lên và tương thích với AGP (Android Gradle Plugin) từ 7.0 đến phiên bản ổn định mới nhất. Trình quản lý SDK của Robolectric tự động tải xuống các phiên bản Android API cần thiết khi chạy lần đầu — đây là thao tác một lần. Đối với máy chủ CI, nên tải trước SDK qua sdkmanager để tránh chậm trễ khi chạy kiểm thử lần đầu. Cập nhật Robolectric lên phiên bản mới thường không yêu cầu thay đổi mã kiểm thử, chỉ cần cập nhật số phụ thuộc trong build.gradle.

Tích hợp với MockK và Mockito

Robolectric tương thích với các framework mock phổ biến: MockK cho Kotlin và Mockito cho Java. Mock được sử dụng để cô lập phụ thuộc: kho lưu trữ, máy khách API, SharedPreferences. Nguyên tắc chính là không mock các lớp Android SDK — có các đối tượng shadow cho việc đó. Chỉ mock các lớp ứng dụng: UseCase, Repository, DataSource và các thành phần logic nghiệp vụ khác. Sự kết hợp giữa đối tượng shadow và mock này mang lại sự linh hoạt tối đa với nỗ lực viết kiểm thử tối thiểu.