Общие шаблоны

Вы можете протестировать свое приложение Compose, используя проверенные подходы и шаблоны.

Тест в изоляции

ComposeTestRule позволяет запустить операцию, отображающую любой компонуемый элемент: всё приложение, отдельный экран или небольшой элемент. Также рекомендуется проверять, правильно ли инкапсулированы компонуемые элементы и работают ли они независимо, что упрощает и делает более целенаправленным тестирование пользовательского интерфейса.

Это не значит, что вам следует создавать только модульные тесты пользовательского интерфейса. Тесты пользовательского интерфейса, охватывающие более крупные его части, также очень важны.

Получите доступ к активности и ресурсам после настройки собственного контента.

Часто требуется задать тестируемое содержимое с помощью composeTestRule.setContent , а также получить доступ к ресурсам активности, например, чтобы проверить, соответствует ли отображаемый текст строковому ресурсу. Однако setContent нельзя вызвать для правила, созданного с помощью createAndroidComposeRule() , если активность уже вызывает его.

Распространенным шаблоном для достижения этой цели является создание AndroidComposeTestRule с использованием пустой активности, например ComponentActivity .

class MyComposeTest {

    @get:Rule
    val composeTestRule = createAndroidComposeRule<ComponentActivity>()

    @Test
    fun myTest() {
        // Start the app
        composeTestRule.setContent {
            MyAppTheme {
                MainScreen(uiState = exampleUiState, /*...*/)
            }
        }
        val continueLabel = composeTestRule.activity.getString(R.string.next)
        composeTestRule.onNodeWithText(continueLabel).performClick()
    }
}

Обратите внимание, что ComponentActivity необходимо добавить в файл AndroidManifest.xml вашего приложения. Для этого добавьте следующую зависимость в свой модуль:

debugImplementation("androidx.compose.ui:ui-test-manifest:$compose_version")

Пользовательские свойства семантики

Вы можете создать пользовательские семантические свойства для предоставления информации в тестах. Для этого определите новый SemanticsPropertyKey и сделайте его доступным с помощью SemanticsPropertyReceiver .

// Creates a semantics property of type Long.
val PickedDateKey = SemanticsPropertyKey<Long>("PickedDate")
var SemanticsPropertyReceiver.pickedDate by PickedDateKey

Теперь используем это свойство в модификаторе semantics :

val datePickerValue by remember { mutableStateOf(0L) }
MyCustomDatePicker(
    modifier = Modifier.semantics { pickedDate = datePickerValue }
)

В тестах используйте SemanticsMatcher.expectValue для подтверждения значения свойства:

composeTestRule
    .onNode(SemanticsMatcher.expectValue(PickedDateKey, 1445378400)) // 2015-10-21
    .assertExists()

Проверить восстановление состояния

Убедитесь, что состояние элементов Compose корректно восстанавливается при повторном создании активности или процесса. Выполняйте такие проверки, не полагаясь на повторное создание активности с помощью класса StateRestorationTester .

Этот класс позволяет имитировать воссоздание составного объекта. Он особенно полезен для проверки реализации rememberSaveable .


class MyStateRestorationTests {

    @get:Rule
    val composeTestRule = createComposeRule()

    @Test
    fun onRecreation_stateIsRestored() {
        val restorationTester = StateRestorationTester(composeTestRule)

        restorationTester.setContent { MainScreen() }

        // TODO: Run actions that modify the state

        // Trigger a recreation
        restorationTester.emulateSavedInstanceStateRestore()

        // TODO: Verify that state has been correctly restored.
    }
}

Тестирование различных конфигураций устройств.

Приложения Android должны адаптироваться ко множеству изменяющихся условий: размерам окон, локальным настройкам, размерам шрифтов, тёмным и светлым темам оформления и т. д. Большинство этих условий определяются значениями на уровне устройства, которые контролирует пользователь и которые отображаются в текущем экземпляре Configuration . Тестирование различных конфигураций непосредственно в тесте затруднено, поскольку тест должен настраивать свойства на уровне устройства.

DeviceConfigurationOverride — API, предназначенный только для тестирования, который позволяет моделировать различные конфигурации устройств локализованным способом для тестируемого содержимого @Composable .

Сопутствующий объект DeviceConfigurationOverride имеет следующие функции расширения, которые переопределяют свойства конфигурации на уровне устройства:

Чтобы применить определенное переопределение, заключите тестируемое содержимое в вызов функции верхнего уровня DeviceConfigurationOverride() , передав применяемое переопределение в качестве параметра.

Например, следующий код применяет переопределение DeviceConfigurationOverride.ForcedSize() для локального изменения плотности, заставляя компонуемый объект MyScreen отображаться в большом альбомном окне, даже если устройство, на котором выполняется тест, напрямую не поддерживает этот размер окна: 

composeTestRule.setContent {
    DeviceConfigurationOverride(
        DeviceConfigurationOverride.ForcedSize(DpSize(1280.dp, 800.dp))
    ) {
        MyScreen() // Will be rendered in the space for 1280dp by 800dp without clipping.
    }
}
DeviceConfigurationOverrideSnippets.kt

Чтобы применить несколько переопределений одновременно, используйте DeviceConfigurationOverride.then() : 

composeTestRule.setContent {
    DeviceConfigurationOverride(
        DeviceConfigurationOverride.FontScale(1.5f) then
            DeviceConfigurationOverride.FontWeightAdjustment(200)
    ) {
        Text(text = "text with increased scale and weight")
    }
}
DeviceConfigurationOverrideSnippets.kt

Дополнительные ресурсы

  • Тестирование приложений на Android : основная целевая страница тестирования Android предоставляет более широкий обзор основ и методов тестирования.
  • Основы тестирования : узнайте больше об основных концепциях тестирования приложений для Android.
  • Локальные тесты : вы можете запустить некоторые тесты локально, на своей рабочей станции.
  • Инструментированные тесты : рекомендуется также проводить инструментированные тесты, то есть тесты, которые выполняются непосредственно на устройстве.
  • Непрерывная интеграция : Непрерывная интеграция позволяет интегрировать ваши тесты в конвейер развертывания.
  • Тестируйте разные размеры экрана . Поскольку пользователям доступно множество устройств, вам следует тестировать экраны разных размеров.
  • Espresso : хотя знание Espresso и предназначено для пользовательских интерфейсов на основе представлений, оно все равно может быть полезным для некоторых аспектов тестирования Compose.