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

Один из основных способов тестирования специальных возможностей – это ручное тестирование. Включите сервисы специальных возможностей, например TalkBack или Switch Access, и проверьте, все ли работает правильно. Это позволяет понять, как пользователи с особыми потребностями могут воспринимать ваше приложение.

Помимо ручной проверки, используйте автоматическое тестирование, чтобы выявлять потенциальные проблемы, которые могут повлиять на удобство использования приложения при внесении в него изменений.

Существующие API тестирования Compose позволяют писать автоматические тесты, которые взаимодействуют с семантическими элементами и проверяют свойства, определенные в вашем пользовательском интерфейсе.

Проверка специальных возможностей

Для автоматического тестирования доступности вы также можете использовать Accessibility Test Framework – тот же базовый фреймворк, на котором работают Сканер доступности и проверки доступности в Espresso. С его помощью можно автоматически выполнять некоторые проверки, связанные с доступностью, начиная с Compose 1.8.0.

Чтобы включить проверки, добавьте зависимость ui-test-junit4-accessibility, вызовите enableAccessibilityChecks() в AndroidComposeTestRule и активируйте действие или tryPerformAccessibilityChecks:

@Rule
@JvmField
val composeTestRule = createAndroidComposeRule<ComponentActivity>()

@Test
fun noAccessibilityLabel() {
    composeTestRule.setContent {
        Box(
            modifier = Modifier
                .size(50.dp, 50.dp)
                .background(color = Color.Gray)
                .clickable { }
                .semantics {
                    contentDescription = ""
                }
        )
    }

    composeTestRule.enableAccessibilityChecks()

    // Any action (such as performClick) will perform accessibility checks too:
    composeTestRule.onRoot().tryPerformAccessibilityChecks()
}
AccessibilitySnippets.kt

Этот тест завершается ошибкой и сообщением о том, что у элемента может не быть ярлыка, который могут прочитать сервисы специальных возможностей.

Другие доступные проверки ищут проблемы с доступностью, связанные с цветовым контрастом, небольшим размером области прикосновения или порядком обхода элементов.

Если вы используете и представления, и Compose, и у вас уже есть AccessibilityValidator или вам нужно его настроить, вы можете задать его в правиле:

@Test
fun lowContrastScreen() {
    composeTestRule.setContent {
        Box(
            modifier = Modifier
                .fillMaxSize()
                .background(color = Color(0xFFFAFBFC)),
            contentAlignment = Alignment.Center
        ) {
            Text(text = "Hello", color = Color(0xFFB0B1B2))
        }
    }

    // Optionally, set AccessibilityValidator manually
    val accessibilityValidator = AccessibilityValidator()
        .setThrowExceptionFor(
            AccessibilityCheckResult.AccessibilityCheckResultType.WARNING
        )

    composeTestRule.enableAccessibilityChecks(accessibilityValidator)

    composeTestRule.onRoot().tryPerformAccessibilityChecks()
}
AccessibilitySnippets.kt

В сочетании с ручным тестированием автоматические тесты с использованием API Compose и Accessibility Test Framework могут помочь вам обнаружить возможные проблемы на ранних этапах процесса разработки.