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

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

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

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

Проверка доступности

Для автоматизированного тестирования доступности вы также можете использовать Accessibility Test Framework — ту же самую базовую структуру, которая лежит в основе Accessibility Scanner и проверок доступности в 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

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

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

Если вы смешиваете Views с 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 могут помочь вам обнаружить возможные проблемы на ранних этапах процесса разработки.