使用 Android Studio 中的布局检查器,您可以将应用布局与设计模型进行比较、显示应用的放大视图或 3D 视图,以及在运行时检查应用布局的细节。如果布局是在运行时(而不是完全在 XML 中)构建的并且布局行为出现异常,该工具会非常有用。
使用布局验证,您可以使用不同的设备和显示配置(包括可变字体大小或用户语言)同时预览布局,以便轻松测试各种常见的布局问题。
打开布局检查器
要打开 Layout Inspector,请执行以下操作:
- 在连接的设备或模拟器上运行您的应用。
- 依次点击 Tools > Layout Inspector。
如图 1 所示,布局检查器将显示以下内容:
- Component Tree:布局中视图的层次结构。
- Layout Display:按照应用布局在设备或模拟器上的显示效果呈现布局,并显示每个视图的布局边界。
- 布局检查器工具栏:布局检查器的工具。
- Attributes:所选视图的布局属性。
图 1. 布局检查器。
选择视图
如要选择某个视图,请在 Component Tree 或 Layout Display 中点击该视图。所选视图的所有布局属性都会显示在 Attributes 面板中。
如果布局包含重叠的视图,您可以选择不在最前面的视图,方法是在 Component Tree 中点击该视图,或者旋转布局并点击所需视图。
隔离视图
如要使用复杂的布局,您可以隔离各个视图,以便只有布局的一部分显示在 Component Tree 中并呈现在 Layout Display 中。
如要隔离某个视图,请在 Component Tree 中右键点击该视图,然后选择 Show Only Subtree 或 Show Only Parent。
如需返回完整视图,请右键点击该视图,然后选择 Show All。
隐藏布局边框和视图标签
如需隐藏布局元素的边界框或视图标签,请点击 Layout Display 顶部的 View Options 图标 ,然后切换 Show Borders 或 Show View Label。
将应用布局与参考图像叠加层进行比较
如需将应用布局与参考图像(如界面模型)进行比较,您可以在布局检查器中加载位图图像叠加层。
- 如需加载叠加层,请点击布局检查器顶部的 Load Overlay 图标
。系统会缩放叠加层以适合布局。
- 如需调整叠加层的透明度,请使用 Overlay Alpha 滑块。
- 如需移除叠加层,请点击 Clear Overlay 图标
。
实时布局检查器
实时布局检查器可以在应用被部署到搭载 API 级别 29 或更高版本的设备或模拟器时,提供应用界面的完整实时数据分析。
如需启用实时布局检查器,请依次转到 File > Settings > Experimental,勾选 Enable Live Layout Inspector 旁边的框,然后点击 Layout Display 上方 Live updates 旁边的复选框。
实时布局检查器包含动态布局层次结构,可随着设备上视图的变化更新 Component Tree 和 Layout Display。
此外,使用属性值解析堆栈,您可以调查资源属性值在源代码中的来源位置,并按照属性窗格中的超链接导航到其位置。

图 2. “Attributes”面板中的属性值,其中包含指向属性定义的超链接。
最后,Layout Display 可在运行时对应用的视图层次结构进行高级 3D 可视化。如需使用该功能,只需在实时布局检查器窗口中点击相应布局,然后拖动鼠标旋转该布局即可。如需展开或收起布局的图层,请使用 Layer Spacing 滑块。
图 3. 布局的旋转 3D 视图。
布局验证
“布局验证”是一款可视化工具,用于同时预览不同设备中及采用不同配置的布局,有助于您在此过程的早期发现布局存在的问题。如需使用该功能,请点击 IDE 窗口右上角的 Layout Validation 标签页:

图 4. “布局验证”标签页。
如需在可用的配置集之间切换,请从“布局验证”窗口顶部的 Reference Devices 下拉列表中选择以下某个配置:
- 参考设备
- 自定义
- 色盲
- 字体大小

图 5. “Reference Devices”下拉菜单选项。
Reference Devices
参考设备是指我们建议您进行对比测试的一组设备,包括手机、可折叠设备、平板电脑和桌面设备。您应该可以预览您的布局在这一组参考设备上的显示效果:
图 6. 布局验证工具中的参考设备预览
自定义
如需自定义要预览的显示配置,请从各种设置(包括语言、设备或屏幕方向)中进行选择:
图 7. 在布局验证工具中配置自定义显示界面
色盲
为了方便色盲用户使用您的应用,请通过常见色盲类型的模拟验证布局:
图 8. 布局验证工具中的色盲模拟预览
字体大小
验证各种字体大小下的布局,并通过使用较大的字体测试布局,改进适用于视力障碍用户的无障碍功能:
图 9. 布局验证工具中的不同字体大小预览
捕获布局层次结构快照
借助布局检查器,您可以保存正在运行应用的布局层次结构快照,以便轻松地与他人分享或日后查看。
快照会捕获您在使用布局检查器时通常看到的数据,包括布局的详细 3D 渲染、视图的组件树、Compose 或混合布局,以及每个界面组件的详细属性。如需保存快照,请按以下步骤操作:
- 打开布局检查器。
- 布局检查器应该会自动连接到您的应用进程。如果未自动连接,请从下拉菜单中选择相应应用进程。
- 如果要捕获快照,请点击布局检查器工具栏中的 Export snapshot
。
- 在出现的系统对话框中,指定快照的名称和保存位置。请务必以
*.li
扩展名保存文件。
然后,您可以通过以下方式加载布局检查器快照:从主菜单栏中依次选择 File > Open,然后打开 *.li
文件。
图 10. Sunflower 示例应用的布局检查器快照。
检查 Compose 语义
在 Compose 中,Semantics 以无障碍服务和测试框架可以理解的替代方式描述您的界面。您可以使用布局检查器检查 Compose 布局中的语义信息。
图 11. 使用布局检查器显示的语义信息。
选择 Compose 节点时,请使用 Attributes 窗口检查相应节点是直接声明语义信息、合并子元素中的语义,还是二者兼有。如需快速识别哪些节点包含已声明或合并的语义,请在 Component Tree 窗口中选择 View options 下拉菜单,然后选择 Highlight Semantics Layers。此操作只会突出显示树中包含语义的节点,并且您可以使用键盘快速浏览这些节点。