3. 采集工具链搭建：Systrace、Perfetto、dumpsys gfxinfo、SurfaceFlinger dump、抓取命令及版本差异

3.1 现象识别阶段：工具链选择决策树

当版本更新后出现帧率抖动或掉帧，首先需要判断当前 Android 版本和环境，以此决定主采集工具。不同版本对工具的兼容性差异直接影响原始数据的完整性。以下是决策树：

Q1: 目标设备 Android 版本 >= 12 (S) ?
 ├─ 是 → Q2: 是否支持 Perfetto 原生 trace？
 │   ├─ 是 → 使用 Perfetto (推荐)，配合 dumpsys gfxinfo 辅助
 │   └─ 否 → 退化到 Systrace + dumpsys gfxinfo
 └─ 否 → Q3: 版本 >= 9 (P) ？
     ├─ 是 → 使用 Systrace + SurfaceFlinger dump + dumpsys gfxinfo
     └─ 否 → 仅 dumpsys gfxinfo + logcat (兼容性受限)

3.2 数据采集阶段：抓取命令与版本适配

3.2.1 Perfetto 抓取（推荐 Android 12+）

Perfetto 支持通过 `perfetto` 命令行、UI 配置文件或长时间后台抓取。帧率回归场景推荐使用以下命令：

# 一次性抓取5秒，包含 CPU、GPU、Display、App 调度
adb shell perfetto \
  -c -o /data/misc/perfetto-traces/trace.perfetto \
  --txt -t 5s \
  'sched freq idle gpu_driver gpu_caches gpu_frame_stall display' \
  --app 'com.android.systemui' \
  --app 'com.example.benchmarkApp'

# 使用 UI 配置文件示例 (config.pbtx)
adb push config.pbtx /data/local/tmp/
adb shell perfetto --config /data/local/tmp/config.pbtx --txt \
  -o /data/misc/perfetto-traces/trace.perfetto

3.2.2 Systrace 抓取（Android 9-11 兼容方案）

在尚未升级 Perfetto 的环境下，使用 `atrace` 后端：

# 抓取10秒核心标签
adb shell atrace --async_start -b 16384 gfx input view webview wm am ss app sync

# 5秒后停止并导出
adb shell atrace --async_dump -o /data/local/tmp/trace_raw.txt
adb pull /data/local/tmp/trace_raw.txt . && adb shell rm /data/local/tmp/trace_raw.txt

# 或直接使用 systrace.py (需安装 Python 2.7)
python systrace.py -b 16384 -t 10 -o trace.html gfx input view webview wm

3.2.3 dumpsys gfxinfo 帧统计

对特定 App 获取帧直方图，判断是否存在掉帧瓶颈：

# 开启帧统计
adb shell dumpsys gfxinfo com.app.package

# 或连续监控
adb shell dumpsys gfxinfo com.app.package framestats

# 输出示例（截取）
Stats since: 1042345678ns
Total frames rendered: 240
Janky frames: 6 (2.50%)
50th percentile: 8ms
90th percentile: 14ms
99th percentile: 33ms
Number of frames: 240
  HISTOGRAM: 0ms=... 2ms=... 4ms=...

3.2.4 SurfaceFlinger dump 图层与合成状态

用于检查 SurfaceFlinger 合成策略、Buffer 状态、VSync 偏移：

# 打印所有 Layer 信息
adb shell dumpsys SurfaceFlinger

# 仅查看帧合成统计（Android 10+）
adb shell dumpsys SurfaceFlinger --list
adb shell dumpsys SurfaceFlinger --frame-stats

# 快速检查 Layer 总数和 Buffer 队列深度
adb shell dumpsys SurfaceFlinger | grep -E "Layer|BufferQueue|drop"

3.3 原因定位阶段：故障树与排查表

利用上述工具的输出，可构建帧率回归原因故障树。以下为典型排查流程：

问题：帧率从60fps降至45fps，存在周期性掉帧

┌─ 1. 检查dumpsys gfxinfo直方图，确认掉帧分布
│   ├─ 集中 >16ms → 可能为CPU/GPU过度负载
│   │   └─ 使用Perfetto查看CPU频率、Binder阻塞、线程调度
│   ├─ 均匀分布 → 可能是VSync偏移或合成策略变化
│   │   └─ 使用SurfaceFlinger dump查看合成模式、HWC vs GPU回退
│   └─ 仅某个界面掉帧 → 单个View/Surface超时
│       └─ 使用Perfetto的ChromeTrace或SurfaceTrace
│
├─ 2. 检查SurfaceFlinger dump合成策略
│   ├─ "HWC 2.0 disabled" → GPU合成负担增加
│   │   └─ 检查GPU帧时间，确认CPU到GPU缓冲区排队
│   └─ "Buffer dropped" → 应用生产帧落后
│       └─ 查看Perfetto的“Display” Pipeline段
│
└─ 3. 检查Perfetto trace的“vsync-app”阶段延迟
    ├─ 延迟超过VSync周期 → 主线程阻塞
    └─ 延迟正常但帧间隔不均匀 → 内部调度抖动

3.4 修复动作与复测验证

根据定位结果执行修复（如回滚GPU驱动、恢复合成策略、调整帧调度线程优先级），然后使用相同的抓取命令进行复测。复测的核心是保持采集参数一致：

• 相同的抓取时长、标签/数据源
• 相同的测试场景（相同界面、相同交互）
• 相同的设备状态（充电/非充电、温度）

复测后对比两个 trace 的帧时间序列直方图，若 90%ile 恢复至 <16ms 且抖动系数降低，则修复有效。

3.5 预防策略：工具链版本基线化

为避免因工具链版本差异导致数据不可比，应在项目启动时确定基线：

• 将 Perfetto 配置文件、Systrace 标签集、dumpsys 参数固化到 CI 脚本中
• 版本升级后自动检测 Perfetto 可用性并切换后端
• 定期运行验证用例，确保采集命令在各版本上均有效