第4章 Perfetto环境搭建：Android端配置、桌面端安装

说实话，Perfetto本身是个非常强大的工具，但很多人第一步就卡在了环境搭建上。我在项目中见过不少团队，花了大半天时间配置环境，结果因为某个细节没注意，抓到的数据根本没法分析。这一节，咱们把Android端和桌面端的配置一次性讲清楚。

4.1 Android端：三步到位

Android端的配置其实不复杂，核心就三步。但我建议你按顺序来，别跳步。我之前有个同事跳过了第二步，结果抓了半小时的trace，关键数据全是空的——白忙活。

1. 启用开发者选项和USB调试：进入「设置」→「关于手机」→ 连续点击「版本号」7次。然后回到「设置」→「系统」→「开发者选项」→ 开启「USB调试」。
2. 配置Perfetto系统属性：连接电脑后执行：

adb shell setprop persist.traced.enable 1
adb shell setprop persist.traced.prop 1

3. 验证adb连接：

adb devices
adb shell perfetto --version

如果能看到设备号和Perfetto版本号，说明Android端已经配好了。嗯，这里要注意——有些国产ROM把开发者选项藏得比较深，你得多翻翻。

4.2 桌面端安装：按平台选方案

桌面端的选择就比较自由了。我个人习惯用macOS做日常开发，但Windows和Linux也完全没问题。下面这张表总结了三种平台的安装方式，你可以直接对照着来。

你想想看，三种方式里最简单的是macOS，一条命令就搞定。Windows稍微麻烦一点，需要手动配置环境变量。我建议你把Perfetto的bin目录放在一个固定的位置，比如 C:\tools\perfetto\，这样后续升级也方便。

Linux用户要注意——apt仓库里的Perfetto版本可能比较旧。我在项目中有一次用apt装了个老版本，结果新版的某些trace解析功能用不了。所以我建议Linux用户直接源码编译，或者从GitHub下载预编译的二进制。

4.3 环境验证：确认一切就绪

配完之后，别急着开始抓trace。先跑一遍验证命令，确保所有组件都能正常工作。下面这几条命令，建议你一条一条跑，别跳过。

# 检查Perfetto版本
perfetto --version

# 检查adb连接
adb devices

# 检查设备端Perfetto可用性
adb shell perfetto --version

# 测试一次简单的trace录制（5秒）
adb shell perfetto -t 5000 -o /data/misc/perfetto-traces/test.pb

如果最后一条命令成功生成了trace文件，说明整个环境已经打通了。我在最开始接触Perfetto时，就是靠这条命令确认环境没问题的。说白了，能录就能分析，后面的事情就顺了。

4.4 环境搭建全景

下面这张图展示了Android端和桌面端的完整配置流程，以及它们之间的连接关系。你可以把它当作一张检查清单，配完一项勾一项。

4.5 常见问题与避坑

环境搭建过程中，有几个坑我替你踩过了，直接列出来，你遇到类似问题可以少走弯路。

• adb devices 识别不到设备：检查USB线是否支持数据传输，部分充电线只供电不传数据。我手上有三条线，只有一条能用，你感受一下。
• perfetto --version 报 command not found：Windows用户记得重新打开命令行窗口，让PATH生效。macOS用户检查brew安装是否成功。
• 录制trace时提示权限不足：Android 10以下需要root，10以上可以通过adb授权。如果遇到权限问题，检查是否开启了「开发者选项」中的「USB调试（安全设置）」。
• 桌面端版本与设备端不匹配：建议桌面端和Android设备使用相同版本的Perfetto。我遇到过版本不一致导致trace文件解析失败的情况，升级后就好了。

好了，环境搭好了，下一步就可以开始抓trace了。记住——环境搭建是基础，基础打牢了，后面分析帧率抖动的时候才不会被工具问题打断思路。