[075]WinScope简介和使用

背景

最近在搞窗口动画的工作，通过拍慢镜头来分析不够精准，所以就尝试使用WinScope。

https://source.android.google.cn/devices/graphics/tracing-win-transitions?hl=cn

一、简介

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

二、捕获跟踪记录

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

2.1 快捷设置

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

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

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

2.2 adb

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

2.2.1 WindowManager 跟踪记录

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

启用跟踪：
adb shell cmd window tracing start

停用跟踪：
adb shell cmd window tracing stop

获取跟踪文件：
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

2.2.2 SurfaceFlinger 跟踪

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

启用跟踪：
adb shell su root service call SurfaceFlinger 1025 i32 1

停用跟踪：
adb shell su root service call SurfaceFlinger 1025 i32 0

获取跟踪文件：
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

2.2.3 事务

如需捕获事务，请执行以下操作：

启用跟踪：
adb shell su root service call SurfaceFlinger 1020 i32 1

停用跟踪：
adb shell su root service call SurfaceFlinger 1020 i32 0

获取跟踪文件：
adb pull /data/misc/wmtrace/transaction_trace.winscope

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

2.3 生成状态转储文件

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 后，选择打开文件以加载跟踪文件。

3.1 使用 WinScope

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

winscope_screenshot.png

如图 在 WinScope 中分析跟踪记录

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

总结

大体上可以了解WinScope通过将日志转化成了可视化的逐帧分析的界面，我简单用了一下，遇到了无法解析wm_trace.winscope的问题，也不知道如何开启屏幕录制，需要进一步的使用，更多功能需要读者自己去尝试使用了。