跟踪窗口转换

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

记录一下Android 跟踪窗口转换 使用方法,每次都翻墙太麻烦.

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

记录跟踪情况

在运行 userdebug 或 eng 版本的设备上通过快捷设置或 adb 记录跟踪情况。

快捷设置

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

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

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

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.pb wm_trace.pb

您可以选择性地为 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.pb layers_trace.pb

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

• 设置缓冲区空间上限（以 KB 为单位）：

  adb shell su root service call SurfaceFlinger 1029 i32 size-value

• 配置日志条目的 Verbose 级别：

  adb shell su root service call SurfaceFlinger 1033 i32 flags

生成状态转储文件

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

WindowManager

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

SurfaceFlinger

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

分析跟踪记录

要分析跟踪文件，请使用 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 中打开跟踪文件后，您便可以通过多种方式对该文件进行分析。

图 1. 在 WinScope 中分析跟踪记录

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