검사 및 디버그

검사

다음과 같은 도구를 사용하면 접근성 관점에서 콘텐츠를 빠르게 검사할 수 있습니다.

  • Android 접근성 도구 모음: 접근성 메뉴, 텍스트 읽어주기, 스위치 제어, TalkBack을 포함하며, 이러한 기술의 사용자에게 앱의 시맨틱이 작동하는 방식에 대한 통계를 제공합니다. Android의 보조 기술을 사용하여 테스트하는 것이 접근성 요구사항이 있는 사용자가 경험할 환경을 파악하는 가장 좋은 방법이므로 적극 권장합니다.
  • 레이아웃 검사기: 각 컴포저블의 시맨틱을 검사하고 디버그할 수 있으며 누락되거나 잘못된 정보를 식별하는 데 도움이 됩니다.
  • 접근성 검사기 앱: 화면을 검사하고 몇 가지 일반적인 문제를 파악하여 접근성을 개선하기 위한 제안사항을 제공합니다.

디버그

Compose, 시맨틱스 시스템, Android 접근성 서비스 간에 추적하기 어려운 예상치 못한 접근성 동작이 발생할 수 있습니다. 시맨틱 속성을 사용하면 구성요소가 특정 방식으로 동작하는 이유를 이해하는 데 도움이 됩니다.

Android 스튜디오의 Layout Inspector, TalkBack 개발자 설정의 TreeDebug 또는 ComposeTestRule의 printToLog를 사용하여 접근성 동작 문제를 디버그할 수 있습니다. 이러한 모든 도구는 Compose에 의해 접근성 서비스에 노출되는 노드(및 속성)에 관한 정보를 제공할 수 있습니다.

다음 예에서는 Layout Inspector를 사용하여 접근성 서비스가 사용 설정된 경우 첫 번째 요소가 선택되지 않고 두 번째 요소에 연결된 작업 피드백이 없는 세 가지 요소가 있는 화면을 디버그합니다. 시맨틱 속성을 검사하여 잠재적인 문제를 찾을 수 있습니다.

Layout Inspector의 구성요소 트리에는 요소의 경계, 매개변수, 이와 관련된 기타 시맨틱 정보가 포함됩니다. 트리에서 세 가지 요소가 모두 인식됩니다.

세 가지 요소가 모두 포함된 Layout Inspector
그림 2. 세 가지 요소가 모두 포함된 Layout Inspector

첫 번째 요소에는 hideFromAccessibility 속성이 적용되어 있습니다. 이는 요소가 시맨틱 트리의 어딘가에 숨겨져 있거나 장식 오버레이로 가려져 있을 수 있음을 나타냅니다.

Layout Inspector: hideFromAccessibility가 있는 첫 번째 요소
그림 3. Layout Inspector: hideFromAccessibility이 있는 첫 번째 요소

두 번째 요소에는 포커스 속성이 있지만 이전 요소와 같은 onClick는 없습니다. 따라서 어딘가에 clickable 수정자가 누락되었을 수 있습니다. 이 때문에 TalkBack과 같은 접근성 서비스가 사용자에게 일부 작업 신호를 알리지 못할 수 있습니다.

Layout Inspector: 포커스가 있는 두 번째 요소
그림 4. Layout Inspector: focused가 있는 두 번째 요소

세 번째 텍스트 요소에는 포커스를 받을 수 있고 onClick가 있으며 다른 추가 시맨틱이 적용되는 등 필요한 모든 속성이 있으므로 예상대로 해석됩니다.

Layout Inspector: 모든 API가 있는 세 번째 요소입니다.
그림 5. Layout Inspector: 모든 API가 있는 세 번째 요소입니다.

이렇게 하면 디버깅 도구를 사용하여 접근성 서비스에서 특정 안내나 선택이 실행되지 않는 이유를 조사할 수 있습니다.