第2章 Perfetto工具链安装与环境检查：SDK下载、adb配置、系统权限、版本兼容性检查清单

2.1 现象识别：环境未就绪的典型表现

当 Perfetto 工具链缺失或配置错误时，抓取 Trace 会提前中断或输出误导信息。以下三类报错出现频率最高：

2.2 数据采集：运行诊断命令收集环境信息

使用下面三组命令快速采集设备环境状态，并将输出保存到日志文件：

# 1. 检查 adb 连接与授权状态
adb devices -l

# 2. 检查 Android 版本与 SDK 级别
adb shell getprop ro.build.version.sdk
adb shell getprop ro.build.version.release

# 3. 检查 Perfetto 可用性
adb shell perfetto --version

# 4. 检查 Shell 权限（是否 root / 是否 shell 用户）
adb shell id

将上述输出粘贴到下方检查清单中，逐项比对：

2.3 原因定位：Perfetto 环境故障树

以下故障树将“Perfetto 环境不可用”逐层拆解为四类根因。请从顶部开始，根据诊断命令的输出沿分支向下推理。

2.4 修复动作：按分支执行修复

根据故障树定位到的叶子节点，选择对应的修复方案：

# Step 1: 下载并配置 SDK
unzip platform-tools-latest-linux.zip -d ~/Android/
echo 'export PATH=$PATH:~/Android/platform-tools' >> ~/.bashrc
source ~/.bashrc

# Step 2: 重启 adb 服务并授权
adb kill-server
adb start-server
adb devices          # 此时设备上应弹出授权弹窗

# Step 3: 确认环境就绪
adb shell getprop ro.build.version.sdk
adb shell perfetto --version

2.5 复测：环境就绪判定标准

执行以下完整命令链，全部通过表示环境就绪：

# 复测脚本（逐行执行，观察输出）
echo "[1] adb 连接状态"
adb devices -l | grep -E "device$" && echo "PASS" || echo "FAIL"

echo "[2] SDK 版本"
sdk=$(adb shell getprop ro.build.version.sdk)
[ "$sdk" -ge "29" ] && echo "SDK $sdk PASS" || echo "SDK $sdk FAIL (<29)"

echo "[3] Perfetto 版本"
ver=$(adb shell perfetto --version 2>/dev/null | grep -oP '\d+\.\d+')
[ -n "$ver" ] && echo "Perfetto $ver PASS" || echo "Perfetto FAIL (not found)"

echo "[4] Shell 权限"
adb shell id | grep -qE "uid=2000|uid=0" && echo "PASS" || echo "FAIL (no shell)"

输出结果应类似：

[1] adb 连接状态
PASS
[2] SDK 版本
SDK 31 PASS
[3] Perfetto 版本
Perfetto 15.2 PASS
[4] Shell 权限
PASS

任意一项 FAIL 则返回故障树对应分支重新修复。

2.6 预防：环境管理规范清单

将以下规范纳入团队 Trace 采集 SOP，避免同类问题重复发生：