Robolectric — что это, принципы работы и юнит-тестирование Android

Что такое Robolectric

Robolectric — это open-source фреймворк, созданный в 2010 году для ускорения тестирования Android-приложений. Вместо запуска на эмуляторе или устройстве, Robolectric предоставляет shadow-реализации классов Android SDK, которые работают непосредственно на виртуальной машине Java (JVM). Это позволяет выполнять тысячи тестов за секунды.

Проблема, которую решает Robolectric

Традиционное Android-тестирование требует запуска приложения на эмуляторе, что занимает 3–10 минут на сборку APK, установку и запуск. Robolectric устраняет этот шаг: тесты компилируются как обычные Java/Kotlin-тесты и запускаются через JUnit. Это даёт цикл обратной связи в несколько секунд вместо минут.

Поддерживаемые версии Android

Robolectric поддерживает все версии Android начиная с API 16 (Android 4.1) и до последней стабильной. Для каждой версии предоставляется соответствующий набор shadow-объектов, которые эмулируют поведение именно той версии платформы, на которой тестируется приложение.

Архитектура и shadow-объекты

Архитектура Robolectric основана на механизме перехвата вызовов через подмену classloader'а. Когда тест вызывает метод Android SDK, Robolectric перехватывает вызов и направляет его в shadow-объект. Shadow-объект — это Java-класс, который имитирует реальное поведение Android-компонента, но работает без нативной платформы.

Как работают shadows

Shadow-объекты реализуют ключевые методы оригинальных Android-классов. Например, ShadowTextView имитирует методы getText(), setText(), getCurrentTextColor() и другие. При вызове textView.setText("Hello") shadow сохраняет строку и возвращает её при вызове getText(). Это изолирует тесты от реального рендеринга и системных сервисов.

Shadow-иерархия

Robolectric поддерживает более 200 shadow-классов, покрывающих основные компоненты Android SDK: Activity, Fragment, TextView, Button, RecyclerView, WebView, LocationManager, ConnectivityManager и многие другие. Shadow-объекты следуют той же иерархии наследования, что и оригинальные классы Android.

Установка и настройка Robolectric

Установка Robolectric в проект Gradle требует добавления зависимости testImplementation "org.robolectric:robolectric:4.x". Также необходимо указать androidsdk-конфигурацию в файле build.gradle и добавить разрешение android:testInstrumentationRunner. Для работы с Robolectric не требуется плагин android-тестов.

Базовая конфигурация Gradle

После добавления зависимости нужно сконфигурировать директорию для манифеста, ресурсов и ассетов. Robolectric автоматически находит AndroidManifest.xml, но может потребоваться указать путь вручную через @Config-аннотацию или системные свойства. Для мультимодульных проектов конфигурация задаётся отдельно для каждого модуля.

// build.gradle — настройка 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'
}

Аннотация @Config

Аннотация @Config позволяет переопределить параметры теста: sdk (версия API), manifest (путь к манифесту), qualifiers (конфигурация экрана, язык). Это полезно для тестирования поведения приложения на разных версиях Android, ориентациях экрана и локализациях.

Написание тестов с Robolectric

Тесты Robolectric пишутся как обычные юнит-тесты с @RunWith(RobolectricTestRunner.class) для JUnit 4 или через RobolectricExtension для JUnit 5. ActivityController управляет жизненным циклом Activity: create(), start(), resume(), pause(), stop(), destroy(). Это позволяет детально тестировать каждый переход состояния.

Тестирование Activity

Для тестирования Activity используется ActivityController, который последовательно проходит через стадии жизненного цикла. Доступ к Activity осуществляется через controller.get(). Все view-компоненты доступны через findViewById, как в реальном приложении. Shadow-объекты позволяют проверить тексты, видимость, цвета и другие атрибуты вью.

@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());
    }
}

Тестирование интентов и навигации

Robolectric перехватывает вызовы startActivity() и позволяет проверить отправленные интенты через ShadowActivity. Это даёт возможность тестировать навигацию: проверить, что при нажатии на кнопку отправляется Intent с правильным Action, Data и Extra-параметрами.

@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 против эмулятора

Robolectric и эмулятор решают разные задачи. Robolectric идеален для быстрых юнит-тестов, проверки логики UI, бизнес-компонентов и репозиториев. Эмулятор необходим для инструментационных тестов, проверки интеграции с API, тестирования камеры, датчиков и производительности.

Тестирование ViewModel и Repository

Robolectric отлично подходит для тестирования ViewModel, Repository и UseCase — компонентов, которые используют Android SDK, но не требуют реального UI. ViewModel тестируется через обычный JUnit-тест с RobolectricExtension, при этом lifecycle-компоненты (LiveData, StateFlow) работают в shadow-среде без моков.

Тестирование LiveData

Robolectic поддерживает LiveData из коробки: можно подписаться на LiveData в тесте, изменить состояние через ViewModel и проверить эмитированное значение. Для асинхронных операций используется InstantTaskExecutorRule или runBlocking для корутин. Это избавляет от необходимости мокать архитектурные компоненты.

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

Кастомные Shadow-объекты

Если стандартные shadow-объекты Robolectric не покрывают нужный класс Android SDK, можно создать кастомный Shadow. Для этого создаётся класс с аннотацией @Implements(ClassName.class) и реализуются нужные методы с @Implementation. Кастомные shadows регистрируются через @Config(shadows = [CustomShadow::class]).

Тестирование ContentProvider и Resources

Robolectric поддерживает тестирование ContentProvider через Robolectric.buildContentProvider(). Можно проверить CRUD-операции, query c URI-матчингом и обработку прав доступа. Ресурсы (строки, цвета, размеры) также доступны через RuntimeEnvironment.application.resources, что позволяет тестировать код, зависящий от ресурсов.

Миграция с эмулятора на Robolectric

Переход с инструментационных тестов на Robolectric требует изменения подхода. Инструментационные тесты (AndroidJUnit4) проверяют реальное поведение на эмуляторе, Robolectric — изолированную логику в shadow-среде. Рекомендуется покрывать Robolectric-тестами бизнес-логику, а инструментационные тесты оставить для интеграционных сценариев.

Адаптация существующих тестов

При миграции нужно: заменить AndroidJUnit4 на RobolectricTestRunner, добавить @Config с целевой версией SDK, заменить ActivityTestRule на ActivityController, и перенести зависимости из androidTestImplementation в testImplementation. Моки (MockK, Mockito) работают с Robolectric без изменений — они не зависят от платформы.

Ограничения при миграции

Robolectric не поддерживает: тестирование камеры (CameraX), NFC, Bluetooth, биометрию, работу с реальными файлами и нативными библиотеками. Для этих сценариев необходимы инструментационные тесты на эмуляторе. Robolectric также не воспроизводит реальный рендеринг — тесты вёрстки лучше выполнять через Compose Test Rule или Espresso. Однако для проверки бизнес-логики, навигации и состояний ViewModel Robolectric полностью заменяет эмулятор с 10-кратным ускорением прогона.

Совместимость с Java и Kotlin версиями

Robolectric требует JDK 11 или выше и совместим с AGP (Android Gradle Plugin) от 7.0 до последней стабильной версии. SDK-менеджер Robolectric автоматически загружает необходимые версии Android API при первом запуске — это однократная операция. Для CI-серверов рекомендуется предварительно загрузить SDK через sdkmanager, чтобы избежать задержек при первом прогоне тестов. Обновление Robolectric до новой версии обычно не требует изменений в коде тестов, только обновление номера зависимости в build.gradle.

Интеграция с MockK и Mockito

Robolectric совместим с популярными mocking-фреймворками: MockK для Kotlin и Mockito для Java. Моки используются для изоляции зависимостей: репозиториев, API-клиентов, SharedPreferences. Главное правило — не мокать классы Android SDK, для этого есть shadow-объекты. Мокайте только слои приложения: UseCase, Repository, DataSource и другие компоненты бизнес-логики. Такая комбинация shadow-объектов и моков даёт максимальную гибкость при минимальных затратах на написание тестов.