4. 系统级帧率数据采集方法：adb shell dumpsys gfxinfo、FrameStats API、Perfetto trace

现象识别

用户或测试人员反馈界面滑动、动画、切换存在肉眼可察觉的卡顿或掉帧，但无法进一步确认是哪个组件、哪段代码导致的帧率抖动。此时需要借助系统级数据采集工具获取量化指标，如每帧耗时、丢帧次数、渲染管线各阶段的耗时。

典型表象符号：

• 应用内滑动出现明显“顿挫感”，每秒帧数低于预期。
• Choreographer 日志中连续出现 Missed vsync 或 FrameTime 突增。
• 开发者选项中的“Profile GPU Rendering”显示柱状图越过绿色阈值线。

数据采集

本节介绍三种系统级帧率数据采集方法，覆盖命令行、API 和全链路追踪。下表对比其适用场景与数据粒度。

4.1 adb shell dumpsys gfxinfo

最常用的命令行工具，输出应用最近 128 帧或自定义帧数的详细时间分布。采集命令：

# 采集指定包名的帧渲染数据
adb shell dumpsys gfxinfo <package.name> framestats

# 输出包含 Draw、Prepare、Process、Execute 等阶段的每帧耗时（纳秒）
# 还包含 NumberFrames、JankyFrames 等丢帧统计

关键输出字段解读：

• Total frames rendered：总渲染帧数。
• Janky frames：耗时超过单帧时间的帧数（VSYNC 周期为 16ms 时，>16ms 的帧为 jank）。
• 90th percentile / 95th percentile：耗时百分位，判断长尾卡顿。
• HISTOGRAM：5ms 区间的直方图，快速识别分布。

4.2 FrameStats API

Android 提供 WindowAnimationFrameStats 与 SurfaceFlingerFrameStats 两个系统 API，可在代码中获取帧时间戳。常用于自动化性能压测或 SDK 集成：

import android.view.WindowAnimationFrameStats;

WindowAnimationFrameStats stats = new WindowAnimationFrameStats();
// 通过 WindowManager 获取帧统计
// 需在 Activity 窗口可见后调用
stats = getWindowManager().getDefaultDisplay()
    .getFrameStats();  // 返回 WindowAnimationFrameStats 对象

long[] frameTimes = stats.getFramesTimes();  // 纳秒时间戳数组
int frameCount = frameTimes.length / 2;      // 每帧包含 start/end 两个时间戳

4.3 Perfetto trace

全链路追踪工具，可捕获 CPU 调度、SurfaceFlinger、HWC、GPU 驱动等多个子系统的时序。采集方法：

# 通过 adb 启动 tracing
adb shell perfetto \
  -c /data/misc/perfetto-configs/frame-trace.cfg \
  -o /data/misc/perfetto-traces/frame_trace.pftrace

# 也可以使用 UI 工具：https://ui.perfetto.dev 配置 trace

典型 trace 配置片段（frame-trace.cfg）：

buffers: {
    size_kb: 20480
}
data_sources: {
    config {
        name: "android.surfaceflinger.frametimeline"
        target_buffer: 0
    }
}
data_sources: {
    config {
        name: "android.framestats"
        target_buffer: 0
    }
}
data_sources: {
    config {
        name: "linux.ftrace"
        ftrace_config {
            ftrace_events: "workqueue/workqueue_execute_start"
            ftrace_events: "workqueue/workqueue_execute_end"
        }
    }
}
duration_ms: 5000

Perfetto 输出可视化的帧时间线，包含 Vsync Event、App 帧生命周期、SurfaceFlinger 合成 三个层级，可直接定位瓶颈在应用还是系统。

原因定位

采集到数据后，按以下故障树逐层排查。下表示意不同方法对应的典型异常指标及可能原因。

修复动作

针对定位到的根因，执行对应修复：

• gfxinfo 显示 Draw/Prepare 阶段超长：优化布局层级（减少嵌套、使用 ConstraintLayout）、将耗时计算移出 UI 线程、使用 AsyncLayoutInflater。
• FrameStats 检测到帧间隔不均匀且集中在 SurfaceFlinger：降低合成频率（调整为局部合成）、关闭不必要的后台窗口动画、使用 GPU 合成替代 HWC 合成。
• Perfetto 发现 GPU 工作时长 > 8ms：减少着色器复杂度、纹理压缩格式改用 ETC2/ASTC、批量提交 draw call。
• CPU 调度延迟（Choreographer 超时）：将渲染线程绑定到 big 核心（sched_setaffinity）、降低同进程其他线程优先级。

修复后应输出修改清单，例如：

# 修复示例：将 RecyclerView 嵌套布局优化为扁平结构
重构前：LinearLayout - FrameLayout - RecyclerView - CardView
重构后：RecyclerView - ConstraintLayout - CardView
预期减少 Draw 耗时 30%~50%

复测

再次使用相同的数据采集方法验证修复效果：

1. 重新运行相同的测试场景（固定滑动距离、动画序列）。
2. 使用 gfxinfo 获取修复前后的丢帧比例对比：

# 修复前
adb shell dumpsys gfxinfo com.example.app framestats | grep "Janky frames"
Janky frames: 23/128

# 修复后
adb shell dumpsys gfxinfo com.example.app framestats | grep "Janky frames"
Janky frames: 3/128

3. 若使用 Perfetto，打开 trace 查看帧时间线是否已全部低于 16ms 绿线。

预防

将系统级帧率采集纳入持续集成与线上监控：

• CI/CD 流水线：对每个版本执行 adb shell dumpsys gfxinfo 自动化测试，阈值失败即阻断发布。
• 线上监控：集成 FrameStats API + WorkManager 周期性采集，上报帧时间戳分布到 APM 系统。
• 例行 Perfetto 热区分析：针对高负载场景（多窗口、游戏模式）定期抓取 trace，建立性能基线。
• 代码 Review 提示：在可能引入渲染开销的 commit 备注中强制要求附上 gfxinfo 前后对比数据。