第三章 工具链搭建：Systrace、Perfetto、GPU渲染分析、dumpsys gfxinfo

帧率抖动的排查高度依赖系统级跟踪工具。本章搭建一套从“时间轴采样 → 线程调度 → GPU渲染管线 → 帧时间直方图”的全链路工具栈，是后续章节所有案例的数据基础。

1. 现象识别：何时启用全链路工具链？

2. 数据采集：四工具启动与配置

2.1 Systrace 采集

# 基本命令（启用核心调度与渲染标签）
python systrace.py -t 8 -o trace.html sched freq idle gfx view input am wm vsync binder_driver

# 指定应用 tag（Android 12+ 推荐）
python systrace.py -t 8 -o trace.html -a com.example.app sched freq gfx view am wm

2.2 Perfetto 采集

# 使用 perfetto 脚本（推荐模式）
adb shell perfetto --txt -c /data/local/tmp/perfetto.config -o /data/misc/perfetto-traces/trace.perfetto-trace

# 最小化配置示例：perfetto.config
buffers: {
    size_kb: 20480
    fill_policy: DISCARD
}
data_sources: {
    config {
        name: "android.trace"
        target_buffer: 0
    }
}
duration_ms: 10000

Perfetto 优势：时间戳精度高、支持 SQL 分析、可追踪内核模块、不依赖 Python 运行环境。

2.3 GPU 渲染分析

# 方法1：开启 profiling 层（无 overlay）
adb shell setprop debug.hwui.profile true
# 方法2：使用 dumpsys GPU 上下文
adb shell dumpsys gfxinfo com.example.app

# 实时查看渲染 pipeline
adb shell dumpsys SurfaceFlinger --latency

2.4 dumpsys gfxinfo 帧直方图

# 启动窗口动画后进行采集
adb shell dumpsys gfxinfo com.example.app framestats

# 输出示例（核心字段）
Window: com.example.app/com.example.MainActivity
Stats since: 1234567890123
Total frames rendered: 450
Janky frames: 37 (8.22%)
Frame time histogram (5 buckets):
  0..4ms: 120
  4..8ms: 200
  8..12ms: 70
  12..16ms: 30
  >16ms: 30

Per-frame stats:
Frame, Draw, Prepare, Process, Execute
1, 3.2, 1.1, 0.8, 4.5
2, 5.1, 2.0, 1.3, 8.9

3. 原因定位：故障树与排查表

排查表：快速匹配工具与症状

4. 修复动作：典型场景与对应措施

1. Systrace 发现 sched_wakeup 到主线程导致预备帧推迟：调整关键渲染线程优先级，使用 setThreadPriority(THREAD_PRIORITY_DISPLAY)。
2. GPU 渲染分析中 Application Buffer 稳定超 16ms：减少布局层级（约束布局替代嵌套 RelativeLayout）、使用硬件层 View.setLayerType(LAYER_TYPE_HARDWARE)。
3. Perfetto 跟踪到 Binder 主线程同步等待 > 8ms：改为异步 Binder 调用或任务队列，避免主线程等待。
4. gfxinfo 显示 Janky frames 集中在 “>16ms” 桶顶部：检查是否在绘制过程中频繁解码图片，前置预加载、使用 LRU 缓存。
5. SurfaceFlinger 合成延迟：减少 Display layer 层数（目标 ≤ 4 层），关闭窗口淡入淡出动画，在 OEM config 中启用 props.sf.hwc_disable_hwc 调试。

5. 复测：验证修复后是否收敛

# 统一的复测流程
# 1. 清除之前数据
adb shell dumpsys gfxinfo com.example.app reset

# 2. 执行相同滑动场景 30 秒
# 3. 采样
adb shell dumpsys gfxinfo com.example.app framestats
# 关键指标：Janky frames 比例 < 1%，且无 >32ms 帧

# 4. 验证 GPU 耗时
adb shell dumpsys gfxinfo | grep "Application Buffer"
# 阈值：P50 < 12ms, P99 < 20ms

6. 预防：将工具链融入日常 CI

• 设置 CI 门禁：每次 MR 提交后自动执行 gfxinfo framestats，若 Janky frames 比例 > 3% 则阻断。
• 构建 trace 回放仓库：对稳定发生的抖动场景，保留 .perfetto-trace 文件，用于回归对比。
• 集成 Perfetto 配置到测试脚本：在 UI 自动化测试中嵌入 adb shell perfetto --txt -c config -o trace，测试结束后自动上传 trace 到分析服务器。
• 定期清理 GPU 数据：adb shell dumpsys gfxinfo com.example.app reset && adb shell dumpsys SurfaceFlinger --latency-clear 积累较长时间后可重置基线。