安卓闪黑工具：aosp16版本Winscope之搜索功能剖析

AOSP16 Winscope搜索功能详解

原创于 2025-08-27 12:00:29 发布 · 1k 阅读

20 ·

CC 4.0 BY-SA版权

文章标签：

#android #framework #安卓窗口系统 #Winscope #安卓framework开发 #闪黑 #黑屏

wms 专栏收录该内容

84 篇文章

订阅专栏

背景：

在aosp16的Winscope体验时候发现多了数据的搜索功能，也体验了一下，这个新功能本身Winscope也自带了很多指导提示，主要是用来解决Winscope有时候寻找某个数据，某个layer时候的不便，本文来详细介绍一下这块搜索如何使用的内容。
体验Winscope搜索功能相关：
在这里插入图片描述

Winscope上数据记录搜索

使用 SQL 在 Winscope Perfetto 跟踪记录中查找特定状态。使用 Winscope 界面中的全局搜索查看器运行查询并直观呈现表格化结果：

搜索查看器标签页

图 1. 搜索查看器标签页

借助搜索查看器，您可以针对 Perfetto 跟踪记录编写和运行自定义 SQL 查询，并访问近期和已保存的查询。Winscope 提供了专用的 SQL 视图，以帮助搜索 SurfaceFlinger 和事务跟踪记录。

注意：我们计划添加辅助视图，以帮助搜索其他类型的跟踪记录。
所有视图应遵守以下规则：

对于 property 和 flat_property 列：

属性名称采用蛇形命名法，例如 LayerProto 中的 visible_region。
点表示法用于表示嵌套属性，例如 visible_region.rect。

property 中的重复字段使用方括号进行区分：

例如，在重复字段 visible_region.rect 的两个实例中，top 字段分别由 visible_region.rect[0].top 和 visible_region.rect[1].top 表示。

flat_property 中的重复字段无法区分：

例如，在重复字段 visible_region.rect 的两个实例中，top 字段在两个实例中都由 visible_region.rect.top 表示。

对于 value 和 previous_value 列：

布尔值由 ‘0’ (False) 或 ‘1’ (True) 表示。

SurfaceFlinger SQL 视图

SurfaceFlinger proto 数据使用以下格式：

图层数据采用 LayerProto 格式。

层次结构根数据采用 LayersSnapshotProto 格式。

如需搜索图层数据，请使用 sf_layer_search 视图。此视图包含以下列：

列	说明
state_id	图层所属条目的唯一 ID
ts	图层所属条目的时间戳
layer_id	图层 ID
parent_id	父级的图层 ID
layer_name	图层名称
property	考虑重复字段的属性名称
flat_property	属性名称不考虑重复字段
value	以字符串格式显示的属性值
previous_value	上一个条目的属性值（字符串格式）

如需搜索层次结构根数据，请使用 sf_hierarchy_root_search 视图。此视图包含以下列：

列	说明
state_id	条目的唯一 ID
ts	条目的时间戳
property	考虑重复字段的属性名称
flat_property	属性名称不考虑重复字段
value	以字符串格式显示的属性值
previous_value	上一个条目的属性值（字符串格式）

示例查询
查找 IME 层具有有效屏幕边界的所有帧：

SELECT ts, value, previous_value FROM sf_layer_search
  WHERE layer_name like 'IME%'
  AND property='screen_bounds.bottom'
  AND value<='24000'

注意：我们计划向 SurfaceFlinger 跟踪记录添加更准确的 isVisible 属性。
查找 Taskbar 层 color.a (alpha) 发生变化的所有帧：

SELECT ts, value, previous_value FROM sf_layer_search
  WHERE layer_name like 'Taskbar%'
  AND property='color.a'
  AND value!=previous_value
查找 Wallpaper 底部边界小于或等于 2400 的所有帧：


SELECT ts, value, previous_value FROM sf_layer_search
  WHERE layer_name LIKE 'Wallpaper%'
  AND property='bounds.bottom'
  AND cast_int!(value) <= 2400

列出具有有效叠加层的显示设备的所有属性：

SELECT STATE.* FROM sf_hierarchy_root_search STATE_WITH_DISPLAY_ON
INNER JOIN sf_hierarchy_root_search STATE
  ON STATE.state_id = STATE_WITH_DISPLAY_ON.state_id
  AND STATE_WITH_DISPLAY_ON.flat_property='displays.layer_stack'
  AND STATE_WITH_DISPLAY_ON.value!='4294967295'
  AND STATE.property LIKE CONCAT(
    SUBSTRING(
        STATE_WITH_DISPLAY_ON.property,
        0,
        instr(STATE_WITH_DISPLAY_ON.property, ']')
    ),
    '%'
  )

事务 SQL 视图

事务 proto 数据使用 TransactionTraceEntry 格式。

如需搜索事务数据，请使用 transactions_search 视图。此视图包含以下列：

列	说明
state_id	proto 属性所属条目的唯一 ID
ts	proto 属性所属条目的时间戳
transaction_id	事务 ID（如有）
property	考虑重复字段的属性名称
flat_property	属性名称不考虑重复字段
value	以字符串格式显示的属性值

示例查询
找到应用了事务的帧，以将层 x 位置更改为 -54.0：

SELECT ts, transaction_id, value FROM transactions_search
  WHERE flat_property='transactions.layer_changes.x'
  AND value='-54.0'

找到添加 ImeContainer 层的帧：

SELECT ts FROM transactions_search
  WHERE flat_property='added_layers.name'
  AND value='ImeContainer'

ShellTransition SQL 视图

过渡 proto 数据使用 ShellTransition 格式。

如需搜索过渡数据，请使用 transitions_search 视图。此视图包含以下列：

列	说明
ts	分派时间 - 如果有发送时间，则回退到发送时间，否则为 0
transition_id	过渡 ID
property	考虑重复字段的属性名称
flat_property	属性名称不考虑重复字段
value	以字符串格式显示的属性值

示例查询
查找由 DefaultMixedHandler 处理的过渡的属性：

  SELECT
    PROPS.ts,
    PROPS.transition_id,
    PROPS.property,
    PROPS.value
  FROM transitions_search HANDLER_MATCH
  INNER JOIN transitions_search PROPS
    ON HANDLER_MATCH.transition_id = PROPS.transition_id
  WHERE HANDLER_MATCH.property = 'handler'
    AND HANDLER_MATCH.value LIKE "%DefaultMixedHandler"
  ORDER BY PROPS.transition_id, PROPS.property

ViewCapture SQL 视图

ViewCapture proto 数据使用 View 格式。

如需搜索 ViewCapture 数据，请使用 viewcapture_search 视图。此视图包含以下列：

列	说明
state_id	视图所属状态的唯一 ID
ts	视图所属状态的时间戳
package_name	软件包名称
window_name	窗口名称
class_name	查看类名称
property	考虑重复字段的属性名称
flat_property	属性名称不考虑重复字段
value	以字符串格式显示的属性值
previous_value	上一个状态的属性值（字符串格式）

示例查询
查找 SearchContainerView 在 y 方向移动时的所有状态：

  SELECT * FROM viewcapture_search
  WHERE class_name LIKE '%SearchContainerView'
    AND flat_property='translation_y'
    AND value!=previous_value

ProtoLog SQL 表

ProtoLog proto 数据使用 ProtoLogMessage 格式。此视图包含以下列：

列	说明
ts	日志的时间戳
level	日志级别
tag	日志记录组标记
message	日志消息
stacktrace	堆栈轨迹（如果有）
location	消息的来源代码位置

示例查询
查找消息中包含 transition 的所有日志：

SELECT ts, message, location FROM protolog
  WHERE message LIKE '%transition%'

查找包含有效事务 ID 的所有日志：

CREATE PERFETTO VIEW valid_tx_ids AS
  SELECT DISTINCT transaction_id FROM transactions_search
  WHERE transaction_id IS NOT NULL AND transaction_id != '0';

SELECT TRANS.transaction_id, message FROM valid_tx_ids TRANS
INNER JOIN protolog LOGS
  ON LOGS.message LIKE CONCAT('%', TRANS.transaction_id, '%');