Trace 抓取¶

通过 adb 从 Android 设备抓取 Perfetto trace。

前置要求¶

adb 在 PATH 中
设备通过 USB 或无线调试连接
仅一台设备连接（或设置 ANDROID_SERIAL 环境变量）

命令¶

trace start¶

开始 trace 抓取。

# 默认：10 秒抓取
perfetto-cli trace start

# 自定义时长
perfetto-cli trace start --duration 30s

# 自定义缓冲区大小
perfetto-cli trace start --buffer-size 64mb

选项：

选项	说明	默认值
`--duration <time>`	抓取时长（如 `10s`、`1m`）	10s
`--buffer-size <size>`	环形缓冲区大小（如 `32mb`、`64mb`）	32mb

trace stop¶

停止抓取并拉取 trace 文件。

perfetto-cli trace stop

trace run¶

一键抓取：开始 → 等待 → 停止 → 拉取。

perfetto-cli trace run --duration 15s -o ./traces

选项：

选项	说明	默认值
`--duration <time>`	抓取时长	10s
`-o, --output <dir>`	trace 文件输出目录	当前目录

工作流程¶

# 1. 启动应用并复现问题
# 2. 抓取 trace
perfetto-cli trace run --duration 15s -o ./traces

# 3. 分析 trace
perfetto-cli -t ./traces/*.perfetto-trace -p com.example.app frame jank

提示¶

对间歇性问题使用更长的抓取时长
增大缓冲区可避免高频 trace 的数据丢失
run 命令最适合脚本化/CI 工作流