第2章 Perfetto工具概览：Trace文件结构、UI界面布局、桌面版与Web版

Perfetto的trace文件不仅仅是二进制数据堆叠——它是一个高度结构化的ProtoBuf序列化包，上层UI围绕“时间线-进程-线程-切片”四维模型组织。理解这一结构，才能在卡顿排查中快速定位哪个阶段、哪段代码拖慢了主线程。

2.1 现象识别：何时需要Perfetto

当App出现以下卡顿特征时，Perfetto trace是首选诊断工具：

• 主线程长时间无响应（ANR阈值5s但实际可能更早感知）
• 帧率掉帧超过15fps，且堆栈采样不足以解释
• 跨进程/线程的依赖链路耗时异常（如Binder调用、SurfaceFlinger合成）
• 怀疑系统服务（如InputDispatcher、Vsync）导致调度延迟

2.2 数据采集：获取Trace文件

采集命令分为 完整模式（含CPU调度、内存、I/O）和 轻量模式（仅主线程切片）。

# 轻量模式（推荐日常排查）
adb shell perfetto -c - --txt -o /data/misc/perfetto-traces/trace.perfetto-trace
# 然后在下面stdin输入配置，按Ctrl+D结束：
data_sources {
  config { name: "linux.ftrace" ftrace_config { ftrace_events: "sched/sched_switch" } }
  config { name: "track_event" }
}
duration_ms: 5000

# 完整模式（需预设配置文件）
adb shell perfetto -c /data/local/tmp/full_trace.cfg -o /data/misc/perfetto-traces/trace.perfetto-trace
# 全量配置示例（卡顿排查推荐）
data_sources: [
  { config { name: "linux.ftrace" ftrace_config { ftrace_events: ["sched/sched_switch","power/cpu_frequency","freq/pstate_sample","lowmemorykiller/*"] }}},
  { config { name: "track_event" }},
  { config { name: "heapprofd" heapprofd_config { sampling_interval_bytes: 4096 }}},
]
duration_ms: 10000
buffers: { size_kb: 65536 }

文件结构概览：每个trace文件是一个ProtoBuf序列流，包含若干包（Packet）。包类型包括：

2.3 原因定位：UI界面布局与关键区域

打开trace后，UI分为四个功能区域，对应排查的不同步骤：

2.4 修复动作：桌面版 vs Web版的选择

Perfetto提供两种打开trace的方式，适用场景不同：

2.5 复测与预防：标准化采集与分析流程

为避免“这次trace跳帧，下次又正常”的随机性，定义以下排查规则：

1. 现象可复现：在相同操作路径下，连续采集3次trace，至少2次出现明显卡顿（>16ms切片）。
2. 标记稳定基线：复测前录制一次无卡顿阶段的trace作为对照，确保UI布局和缩放标准一致。
3. 构建检查清单：每次打开新trace后，按顺序检查：① 目标进程是否在列表 ② Vsync边界是否连续 ③ 主线程是否有长度>50ms的切片 ④ Binder调用是否出现长时间等待。
4. 自动化辅助：使用桌面版的Metrics面板运行android_jank_cuj.sql脚本，自动输出卡顿切片分布。