返回应用的布局树。
用法
android layout [-dhp] [--device=PARAM] [--flat] [--full] [--no-idle] [--output=PARAM]
选项
--device=PARAM- 设备序列号。-d,--diff- 已弃用；无操作标志。将在未来版本中移除。--flat- 返回扁平列表，而不是树。--full- 返回完整树，包括非互动元素和隐藏元素。-h,--help- 显示指定命令的帮助消息。--no-idle- 在提取布局时，不等待布局空闲状态。-o,--output=PARAM- 将布局写入指定文件或目录。如果省略，则输出到标准输出。-p,--pretty- 以美观的格式输出返回的 JSON。
android 个选项：
--sdk=PARAM- Android SDK 的路径。-v,--verbose- 启用详细输出以进行问题排查。-V,--version- 打印版本信息并退出。
说明
android layout 可捕获已连接的 Android 设备或模拟器上活跃屏幕的实时界面层次结构，并以 JSON 格式输出。
AI 代理和测试脚本可以使用 android layout 来检查可见文本、资源 ID、无障碍功能说明、互动状态和元素边界，而无需仅依赖于视觉屏幕截图。
设置布局输出的格式和过滤布局输出
-p, --pretty：设置 JSON 输出的格式，使其包含缩进和换行符，以便于人工读取。-o, --output：将布局 JSON 写入指定的文件路径，而不是标准输出。--flat：输出扁平的 JSON 界面节点列表，而不是嵌套的层次树。--full：包括默认情况下会被过滤掉的非互动式和隐藏式界面元素。--no-idle：立即捕获布局，而无需等待应用界面线程达到空闲状态。
示例
打印当前屏幕的格式精美的界面布局树：
android layout --pretty
将完整的界面层次结构（包括非互动元素）保存到文件中：
android layout --pretty --full --output=./hierarchy.json