自 2025 年 3 月 27 日起,我们建议您使用 android-latest-release
而非 aosp-main
构建 AOSP 并为其做出贡献。如需了解详情,请参阅 AOSP 的变更。
ViewCapture
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
ViewCapture 转储是窗口的视图层次结构在特定时间的快照,包括位置、大小、缩放比例和可见性。另一方面,ViewCapture 跟踪记录会按时间顺序显示状态序列,以便用户了解视图在不同时间的行为。简而言之,ViewCapture 会捕获窗口中的视图及其属性的相关信息,以便您了解特定时刻的用户体验,并跟踪随时间的变化。这对于排查“我的电池图标缺失”或“我的通知闪烁”等问题非常有用。
借助 Winscope 的 ViewCapture 查看器,您可以直观呈现特定时间点的视图状态,查看视图随时间的变化,以及分析视图层次结构数据以查找 bug 或异常。与屏幕录制相比,逐帧可视化可让您更轻松地检查视图状态。收集视图跟踪记录所需的 CPU 资源也比屏幕录制少,因此更易于启用。
如需详细了解跟踪记录收集,请参阅 ViewCapture。
标签页结构
ViewCapture 标签页分为三个面板:矩形视图、层次结构视图和属性视图:
图 1. ViewCapture 跟踪记录分析。
矩形视图
界面左侧显示视图层次结构的 3D 视图。矩形视图会考虑视图边界、z 轴顺序和不透明度。
矩形视图顶部有一个菜单,用于显示所有可用窗口。在选择要显示的内容时,您可以选择特定窗口或所有窗口:
图 2. ViewCapture 矩形视图。
层次结构视图
该标签页的中心部分显示视图层次结构。除了视图之间的父子关系之外,此视图还包含以下信息:
属性视图
为了让调试更轻松,ViewCapture 查看器提供了一系列精选属性,以便以更有条理的格式呈现信息:此列表包含以下类别:
- 视图:视图标识符。
- 几何图形:坐标、尺寸、缩放比例以及有关视图几何图形的其他详细信息。
- 效果:视图的效果和其他各种属性。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-03-04。
[null,null,["最后更新时间 (UTC):2025-03-04。"],[],[],null,["# ViewCapture dumps are snapshots of a window's view hierarchy at a specific time,\nincluding location, size, scale, and visibility. ViewCapture traces, on the\nother hand, provide a chronological sequence of states, offering insights into\nhow views behave over time. Simply put, ViewCapture captures information about\nviews within a window and their properties, letting you understand the user\nexperience at specific moments and track changes over time. This is useful for\ntroubleshooting issues like *my battery icon is missing* or *my notification\nflickered*.\n\nWinscope's ViewCapture viewer lets you visualize the view state at a moment in\ntime, watch view changes over time, and analyze view hierarchy data for bugs or\nanomalies. The frame-by-frame visualization makes it easier to inspect view\nstates compared to screen recordings. Collecting view traces is also less\nCPU-intensive than screen recording, making it easier to enable.\n\nSee [ViewCapture](/docs/core/graphics/winscope/capture/adb#capture-adb-vc)\nfor more information about trace collection.\n\nTab structure\n-------------\n\nThe ViewCapture tab is split in three panels: rects view, hierarchy view, and\nproperties view:\n\n**Figure 1.** ViewCapture trace analysis.\n\n### Rects view\n\nThe left side of the screen features a 3D view of the view hierarchy. The rects\nview considers view bounds, z-order, and opacity.\n\nThe rects view has a menu at the top that displays all available\nwindows. You can select a specific window or all of them when choosing what to\ndisplay:\n\n**Figure 2.** ViewCapture rects view.\n\n### Hierarchy view\n\nThe tab's central segment shows the view hierarchy. In addition to the\nparent-child relationships between view, this view also includes the following\ninformation:\n\n- **V:** Identifies visible views.\n\n### Properties view\n\nTo make debugging easier, the ViewCapture viewer provides a curated list of\nproperties, presenting the information in a more organized format. This list\nincludes the following categories:\n\n- **View:** View identifier.\n- **Geometry:** Coordinates, size, scale, and other details about the view geometry.\n- **Effects:** Effects and other miscellaneous properties for the views."]]