跟踪窗口转换

WinScope 提供了用于在窗口转换期间和转换后记录和分析 WindowManager 状态和 SurfaceFlinger 状态的基础架构和工具。WinScope 将所有相关的系统服务状态记录在一个跟踪文件中,您可以使用该文件重现并逐步查看转换。

捕获跟踪记录

在运行 userdebug 或 eng build 的设备上通过快捷设置adb 捕获跟踪记录。

快捷设置

要通过快捷设置记录跟踪情况,请执行以下操作:

  1. 启用开发者选项
  2. 依次转到开发者选项 > 快捷设置开发者图块
  3. 启用 WinScope 跟踪
  4. 打开快捷设置
  5. 点按 Winscope 跟踪以启用跟踪。
  6. 在设备上执行窗口转换。
  7. 窗口转换完成后,打开快捷设置,然后点按 Winscope 跟踪记录以停用跟踪记录。

跟踪记录会被写入 /data/misc/wmtrace/wm_trace.winscope/data/misc/wmtrace/layers_trace.winscope,同时还会包含在错误报告中。

adb

通过 adb 捕获跟踪记录时,请分别捕获 WindowManager 和 SurfaceFlinger 的跟踪记录。

WindowManager 跟踪记录

要记录 WindowManager 的跟踪情况,请执行以下操作:

  1. 启用跟踪:
    adb shell cmd window tracing start
  2. 停用跟踪:
    adb shell cmd window tracing stop
  3. 获取跟踪文件:
    adb pull /data/misc/wmtrace/wm_trace.winscope wm_trace.winscope

您可以选择性地为 WindowManager 跟踪更改各种设置的默认日志配置:

  • 设置日志频率(针对事务或帧):
    adb shell cmd window tracing [frame | transaction]
  • 配置日志条目的 Verbose 级别:
    adb shell cmd window tracing level [all | trim | critical]
  • 设置缓冲区空间上限(以 KB 为单位):
    adb shell cmd window tracing size size-value
  • 转储缓冲区状态、日志级别、剩余容量和元素数量:
    adb shell cmd window tracing status

SurfaceFlinger 跟踪

要记录 SurfaceFlinger 的跟踪情况,请执行以下操作:

  1. 启用跟踪:
    adb shell su root service call SurfaceFlinger 1025 i32 1
  2. 停用跟踪:
    adb shell su root service call SurfaceFlinger 1025 i32 0
  3. 获取跟踪文件:
    adb pull /data/misc/wmtrace/layers_trace.winscope layers_trace.winscope

您可以选择性地为 SurfaceFlinger 跟踪更改各种设置的默认日志配置:

  • 设置缓冲区空间上限(以 KB 为单位):
    adb shell su root service call SurfaceFlinger 1029 i32 size-value
  • 配置日志条目的 Verbose 级别:
    adb shell su root service call SurfaceFlinger 1033 i32 flags

事务

如需捕获事务,请执行以下操作:

  1. 启用跟踪:
    adb shell su root service call SurfaceFlinger 1020 i32 1
  2. 停用跟踪:
    adb shell su root service call SurfaceFlinger 1020 i32 0
  3. 获取跟踪文件:
    adb pull /data/misc/wmtrace/transaction_trace.winscope

`/data/misc/wmtrace/` 中提供了更多事务合并文件,并采用 `transaction_merges_*.winscope` 的文件命名方式。

生成状态转储文件

WinScope 可以从错误报告中读取 WindowManager 状态和 SurfaceFlinger 状态的快照。错误报告会将状态信息以单独的 proto 文件的形式存储在 proto 文件夹中。如需使用 adb 生成状态转储文件,请运行以下命令。

WindowManager

adb exec-out dumpsys window --proto > window_dump.winscope

SurfaceFlinger

adb exec-out dumpsys SurfaceFlinger --proto > sf_dump.winscope

分析轨迹

如需分析轨迹文件,请使用 WinScope Web 应用。您可以在源代码的基础上构建此应用,也可以从预构建目录中打开此应用。

  1. 从 Android 源代码库中下载预构建的软件工件:
    curl 'https://android.googlesource.com/platform/prebuilts/misc/+/master/common/winscope/winscope.html?format=TEXT' | base64 -d > winscope.html
  2. 在网络浏览器中打开下载的软件工件。
  3. 打开 WinScope 后,选择打开文件以加载跟踪文件。

使用 WinScope

在 WinScope 中打开跟踪文件后,可以通过多种方式对该文件进行分析。

WinScope 屏幕截图
图 1. 在 WinScope 中分析跟踪记录
  • 时间轴 - 您可以通过时间轴查看跟踪记录中的事件序列。您可以使用箭头键或点击各个条目以浏览时间轴。
  • 屏幕 - 您可以在屏幕上直观地查看每个可见窗口。点击屏幕上的某个窗口即可选择层次结构中相应的源窗口。
  • 屏幕录制 - 您可以通过屏幕录制查看与跟踪记录同步的设备屏幕。结合时间轴一起导航。
  • 层次结构 - 您可以通过层次结构查看系统已知的每个窗口。有些窗口不包含缓冲区,它们存在的目的在于为其子项设置政策。可见窗口均标有 V 图标。
  • 属性 - 您可以在属性中查看层次结构中所选条目的状态信息。