앱의 레이아웃 트리를 반환합니다.
사용
android layout [-dhp] [--device=PARAM] [--flat] [--full] [--no-idle] [--output=PARAM]
옵션
--device=PARAM- 기기 일련번호입니다.-d,--diff- 지원 중단됨, no-op 플래그입니다. 향후 버전에서 삭제될 예정입니다.--flat- 트리 대신 플랫 목록을 반환합니다.--full- 비상호작용 요소와 숨겨진 요소를 포함한 전체 트리를 반환합니다.-h,--help- 지정된 명령어의 도움말 메시지를 표시합니다.--no-idle- 레이아웃을 가져올 때 레이아웃 유휴 상태를 기다리지 않음-o,--output=PARAM- 지정된 파일 또는 디렉터리에 레이아웃을 씁니다. 생략하면 표준 출력에 인쇄됩니다.-p,--pretty- 반환된 JSON을 pretty-print합니다.
android 옵션:
--sdk=PARAM- Android SDK의 경로-v,--verbose- 문제 해결을 위해 상세 출력을 사용 설정합니다.-V,--version- 버전 정보를 인쇄하고 종료합니다.
설명
android layout는 연결된 Android 기기 또는 에뮬레이터의 활성 화면의 라이브 UI 계층 구조를 캡처하고 JSON 형식으로 출력합니다.
AI 에이전트와 테스트 스크립트는 시각적 스크린샷에만 의존하지 않고 android layout를 사용하여 표시되는 텍스트, 리소스 ID, 접근성 설명, 상호작용 상태, 요소 경계를 검사할 수 있습니다.
레이아웃 출력 형식 지정 및 필터링
-p, --pretty: 사람이 읽을 수 있도록 들여쓰기 및 줄 바꿈을 사용하여 JSON 출력을 형식화합니다.-o, --output: 표준 출력 대신 지정된 파일 경로에 레이아웃 JSON을 씁니다.--flat: 중첩된 계층 구조 트리 대신 UI 노드의 플랫 JSON 목록을 출력합니다.--full: 기본적으로 필터링되는 비상호작용 및 숨겨진 UI 요소를 포함합니다.--no-idle: 앱 UI 스레드가 유휴 상태가 될 때까지 기다리지 않고 레이아웃을 즉시 캡처합니다.
예
활성 화면의 예쁘게 형식이 지정된 UI 레이아웃 트리를 출력합니다.
android layout --pretty
전체 UI 계층 구조 (비상호작용 요소 포함)를 파일에 저장합니다.
android layout --pretty --full --output=./hierarchy.json