Проверка и отладка

Проверка

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

• Специальные возможности Android. Включают меню специальных возможностей, функции "Озвучивание при нажатии" и Switch Access, а также программу TalkBack. С их помощью вы можете понять, как семантика вашего приложения работает для пользователей этих технологий. Тестирование с помощью технологий специальных возможностей Android настоятельно рекомендуется как лучший способ понять, с чем столкнутся ваши пользователи с особыми потребностями.
• Инспектор макетов. Позволяет проверять и отлаживать семантику каждой composable-функции, а также помогает выявлять отсутствующую или неверную информацию.
• Сканер доступности. Это приложение сканирует экран и предлагает варианты его доработки. Тестируются компоненты, важные для пользователей с ограниченными возможностями.

Отладка

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

Для отладки специальных возможностей можно использовать инспектор макетов в Android Studio, TreeDebug в настройках TalkBack для разработчиков или printToLog в ComposeTestRule. Все эти инструменты могут предоставлять информацию об узлах (и их свойствах), которые предоставляются службам специальных возможностей Compose.

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

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

Рисунок 2. Инспектор макетов со всеми тремя элементами.

К первому элементу применено свойство hideFromAccessibility. Это указывает на то, что элемент может быть помечен как скрытый где-то в дереве семантики или он скрыт каким-то декоративным наложением.

Рисунок 3. Инспектор макетов: первый элемент с hideFromAccessibility.

У второго элемента есть свойство focus, но нет onClick, как у предыдущего. Поэтому в нем может отсутствовать модификатор clickable, из-за чего сервис специальных возможностей, например TalkBack, не сообщает пользователю о некоторых действиях.

Рисунок 4. Инспектор макетов: второй элемент с focused.

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

Рисунок 5. Инспектор макетов: третий элемент со всеми API.

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