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

Android 使用 Winscope 跟踪窗口转换 Winscope 是一款 Web 工具,可以让用户在动画和转换期间和之后记录、重放和分析多个系统服务的状态。Winscope 将所有相关的系统服务状态记录在一个跟踪文件中。使用带有跟踪文件的 Winscope 界面,您可以通过重放、单步执行和调试转换来针对每个动画帧检查这些服务的状态(无论是否有屏幕录制)。 阅读详情

背景:

在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, '%');

运行查询

使用左侧面板时,系统会开始搜索跟踪记录。此过程需要几秒钟的时间。在开始时,时间轴不可用。

开始跟踪记录搜索后,在搜索框中输入查询,然后点击 Run Search Query 或按键盘上的 Enter 以运行该查询。

完成后,结果表格会显示在中间面板中。您的查询会显示在搜索框下方,并带有一个在会话之间保存查询的字段。

您可以通过点击左侧面板中的 Saved 标签页来访问已保存的查询,也可以通过点击 Recent 标签页来访问最近运行的查询:

搜索查看器左侧面板

图 2. 搜索查看器左侧面板。

结果

所有查询都会返回表格式结果,并在可滚动视图中显示,其交互行为类似于基于日志的跟踪记录查看器(例如 Transactions 和 ProtoLog):

搜索查看器结果

图 3. 搜索查看器结果。

如果生成的表格包含 ts 列,则该列中的值会被解释为时间戳,并作为新行条目添加到时间轴叠加层中。点击此行,然后使用向左和向右箭头键在条目之间导航:

搜索时间轴

图 4. 搜索时间轴。

frameworks 之 Winscope 工具 阅读详情

相关推荐

从Perfetto到Winscope:AOSP16新版调试工具链完整搭建指南(含视频同步技巧)

本文提供了AOSP 16新版调试工具链的完整搭建指南,重点介绍了如何从源码构建Winscope并与Perfetto深度整合。内容涵盖环境配置、追踪捕获的三种路径、Perfetto配置文件详解,并特别分享了视频录制与时间轴同步的实战技巧,帮助Android系统工程师高效调试UI渲染与窗口动画问题。

weixin_29223603的博客 534

android display笔记(二)winscope的使用

跟踪记录会被写入 /data/misc/wmtrace/wm_trace.winscope 和 /data/misc/wmtrace/layers_trace.winscope,同时还会包含在错误报告中。通常使用prebuilts/misc/common/winscope下的winscope.html。窗口转换完成后,打开快捷设置,然后点按 Winscope 跟踪记录以停用跟踪记录。依次转到开发者选项 > 快捷设置开发者图块。点按 Winscope 跟踪以启用跟踪。点击Add FILE。

镇元子的博客 5614

AOSP 16 Winscope编译与ViewCapture实战指南

Winscope 是 Android 系统级 UI 调试工具,其核心能力源于 ViewCapture——一种在运行时对 View 树进行结构化、实时镜像采集的技术机制。它并非简单截图增强,而是通过钩住 Choreographer 帧回调与 ViewRootImpl 生命周期,实现毫秒级同步的私有状态(如 mPrivateFlags、mDirty)采集。该技术依赖 AOSP 构建系统与 Gradle 插件生态间的隐性契约,涉及 compileSdkVersion、AGP 版本、buildToolsVersio

weixin_33919950的博客 340

android车机手机黑屏闪黑终结者-Winscope工具使用介绍

在开发过程中,经常会遇到各种各样的窗口问题,比如动画异常、窗口异常、闪屏、闪黑、黑屏、错位显示…对于这些问题,添加日志,调试分析代码等手段去解决,但这些 UI 问题往往出现在一瞬间,很难把握出现的时机,录制下来的日志往往也是巨大的,从海量的日志中提取有效的信息是一个枯燥且繁琐的事情,而且也根本没有办法把显示时间戳和日志时间戳完全对好。Android 也意识到了这个问题,WinScope 的出现有效的帮助我们跟踪窗口和显示问题。它向开发者提供一个可视化的工具,让开发者能使用工具跟踪整个界面的变化过程。

learnframework的博客 6674

AOSP16 Winscope搜索功能实战:5个高效SQL查询技巧帮你快速定位UI问题

本文详细介绍了AOSP16中Winscope工具的SQL查询功能,提供5个高效SQL查询技巧帮助开发者快速定位UI问题。通过精准查询图层属性、复合条件筛选、事务状态分析等方法,结合Perfetto跟踪记录,大幅提升Android UI调试效率。

weixin_30733003的博客 567

实战指南:AOSP 16 Winscope编译避坑与ViewCapture新特性深度解析

本文提供了AOSP 16中Winscope工具的实战编译指南与深度解析。针对编译过程中常见的网络依赖、npm模块缺失及Python 3.10+强制要求等关键问题,给出了详尽的避坑方案。文章重点剖析了Winscope在AOSP 16中的新特性,特别是ViewCapture功能的完善与实战配置方法,帮助开发者高效进行系统UI与动画的深度调试。

jupyter5notebook的博客 477

必读干货:aosp/安卓16版本winscope编译踩坑过程及相关新特性介绍

Winscope这个开发工具其实每个安卓版本都在更新,而且每个版本的编译方法都有所不同,一般新版本Winscope和设备安卓版本还要进行匹配,不然可能会存在一定的兼容性问题。在以前14,15初期rc版本,其实不会有这个网络问题,那时候不会去Fetch,那么现在这个问题怎么办呢?那只能考虑楼梯啦,具体方法大家自己考虑哈,反正要解决你的terminal可以访问google既可以。今天受vip学员的求助,我们来探索aosp16版本Winscope编译全过程及相关的新特性体验。

learnframework的博客 2216

AOSP 16 Winscope ViewCapture编译与实战指南

Android View调试是Framework层开发的核心能力,涉及View树结构、渲染流程、跨进程UI协同等底层机制。Winscope作为AOSP原生可视化调试服务,其ViewCapture特性实现了帧级对齐的实时View快照捕获、跨进程View树拼接与动态属性注入,显著提升SystemUI、Launcher等系统应用的卡顿归因与性能优化效率。该能力依赖AOSP构建体系深度集成,需匹配OpenJDK 17、正确ABI配置及平台签名,且ViewCapture功能默认关闭,必须通过Android.bp、An

weixin_34159110的博客 356

android 常规log、dump、winscope常见抓取方法

则对应的代码可以通过 grep 抓取 writeWmxxx 找出是在哪里打印的该events log。events log开头的字段,比如wm_xxx。应用走到onresume生命周期的log。通知cancel的log。

yimelancholy的博客 4477

深入解析AOSP16 Winscope:Perfetto SQL查询在安卓图形调试中的实战应用

本文深入解析了AOSP16 Winscope中基于Perfetto SQL的全局搜索功能,这一革命性工具将安卓图形调试从手动排查带入智能查询时代。通过实战案例,详细展示了如何利用SQL查询精准定位输入法闪烁、任务栏透明度异常等典型图形问题,并提供了数据模型解读、高阶技巧与避坑指南,大幅提升系统与应用开发者的调试效率。

brown的博客 291

从零到一:AOSP 16 Winscope编译实战与网络依赖的深度解析

本文详细解析了在AOSP 16中编译Winscope工具时遇到的网络依赖挑战与实战解决方案。针对因网络受限导致npm install及构建失败的问题,文章提供了从环境准备、依赖分析到构建流程的完整指南,并重点介绍了离线环境准备、本地镜像配置等实用方法,帮助开发者成功构建这一关键的Android图形系统调试工具。

carrot的博客 246

Winscope新特性实战:用AOSP 16输入追踪功能优化交互设计

本文深入解析AOSP 16中Winscope工具的输入追踪新特性,帮助开发者优化交互设计。通过精确追踪硬件输入事件时序、系统处理流水线等关键数据,结合View Capture功能,实现从触摸到画面更新的完整分析。文章还提供了手势响应延迟优化实战和高级调试技巧,助力提升安卓应用的交互性能。

e1f2g的博客 743

Winscope工具使用

在Android系统开发过程中,我们经常会遇到各种瞬时性的窗口显示问题,比如闪黑、冻屏、动画异常、窗口错位等。传统调试方法如dumpsys SurfaceFlinger和dumpsys window windows虽然能提供有用信息,但对于转瞬即逝的问题往往难以捕捉关键瞬间。即便成功捕获到黑屏瞬间的日志,分析时仍需结合前后帧的上下文信息才能准确定位问题根源。这类UI问题的调试面临三大挑战:首先,问题出现时机难以把握;其次,日志文件通常非常庞大,从中提取有效信息费时费力;

Red风信子的博客 612

aosp15/16版本Winscope新特性ViewCapture实战支持

本文介绍了Android系统应用中使用ViewCapture工具捕获视图层级的配置方法。ViewCapture通过遍历视图树获取属性信息,相比屏幕录制性能开销更小。文章详细说明了如何在系统应用中添加依赖、初始化ViewCapture实例,并提供了Activity和Window两种场景的代码示例。同时指出了ViewCapture的性能和内存限制,建议仅在调试时使用。最后通过对比实验证明,未配置时Winscope无法捕获视图层级,而正确配置后可成功捕获Activity视图信息。该工具为系统UI调试提供了有效手段

liaosongmao1的专栏 104

android V winscope离线包

android V winscope离线包

信号削峰CFR基础知识介绍(一)

接下来,将得到的峰值分成若干段,在每一段中,仅保留该段内所有峰值中幅度最大的峰值。为了减少不必要的带外泄露,削峰后的信号将通过一个低通滤波器,以减少对应于削峰后信号中尖锐拐角的高频信号。首先,它识别出高于由目标PAPR确定的阈值的峰值。在峰值加窗算法中,削峰是通过在峰值区域将原始信号与一个加窗函数相乘来实现的,如下图所示。其中,w(n) 是一种常见的加窗函数,如凯撒窗、高斯窗和汉明窗等,而 p(n) 是一个加权系数。如上图所示,削峰会导致削峰后的信号出现尖锐的拐角,从而引发不必要的带外辐射(ACP增加)。

weixin_49761275的博客 1553

Android 12 ViewCapture实战:Winscope编译与UI性能深度分析

ViewCapture是Android 12(AOSP 16)引入的核心UI性能诊断机制,它通过在ViewRootImpl中植入轻量级钩子,实现对measure/layout/draw全生命周期的结构化数据采集,突破传统Systrace和Layout Inspector的采样局限。其原理基于内存环形缓冲区+Protobuf序列化,支持微秒级时间戳、View树深度、绘制耗时等12维指标,为卡顿定位提供可追溯的原始证据链。技术价值体现在精准归因——如无效requestLayout、Canvas过度调用、线程阻塞

weixin_34319817的博客 317

FPGA实现电机转速PID控制

通过纯RTL实现电机转速PID控制,包括电机编码器值读取,电机速度、正反转控制,PID算法,卡尔曼滤波,最终实现对电机速度进行控制,使其能够渐近设定的编码器目标值。

STATEABC的博客 7550
上一篇: 安卓音频audio框架系统学习必知必会的一些术语
下一篇: 程序员入职大厂工作背景调查注意点
千里马学框架
博客等级 码龄6年 1万+粉丝 652原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

千里马学框架

帮助你了,就请我喝杯咖啡

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值