### 3. 环境搭建与工具链配置：PerfDog安装与设备连接、Profiler远端调试配置、adb与开发者选项准备
#### 3.1 概述与原理
帧率抖动的定位依赖数据采集工具链的可靠性。环境搭建的目的是在**开发机（Windows/macOS）** 与**目标设备（Android/iOS）** 之间建立低延迟、稳定的数据通道，确保工具能够获取到不含自身干扰的渲染性能数据。
- **PerfDog**：通过adb或私有协议注入目标进程，轮询帧时间、CPU/GPU频率与温度。
- **Profiler远端调试**：利用adb forward/tcpip将设备端性能数据转发到Unity/Unreal Editor，避免USB线长导致数据断流。
- **adb与开发者选项**：adb负责命令传输与端口映射；开发者选项用于解锁USB调试、不锁定屏幕、显示GPU过度绘制等调试开关。
#### 3.2 实现流程总览
| 步骤 | 操作内容 | 关键命令/配置 | 验证方法 |
|------|----------|---------------|----------|
| 1 | 准备开发者选项 | 设置→关于手机→连续点击版本号7次 | 设置中出现“开发者选项”菜单 |
| 2 | 开启USB调试 | 开发者选项→USB调试→允许 | adb devices 显示设备号 |
| 3 | 安装adb驱动与平台工具 | 下载platform-tools并加入PATH | adb version 输出版本号 |
| 4 | 安装PerfDog | 官网下载→拖入Applications或解压 | PerfDog.app 可启动，界面可见 |
| 5 | 连接设备并授权 | USB线连接→设备上点击“允许USB调试” | adb devices 显示 "device" |
| 6 | 配置Profiler远端 | adb forward tcp:端口 或 adb tcpip 5555 | Unity Profiler可连接设备IP:端口 |
| 7 | 验证数据通路 | PerfDog开始录制，Profiler开始采样 | 帧时间曲线更新，无断流 |
#### 3.3 环境搭建流程图
以下SVG展示了**从开发机到目标设备**的核心工具链组件与连接关系，适用于快速排查连接异常时的依赖检查。
#### 3.4 关键配置与命令详解
##### 3.4.1 adb基础环境准备
下载Google官方平台工具（platform-tools），解压后将其路径加入系统环境变量`PATH`。
# 验证adb可用性
adb version
# 预期输出示例：
# Android Debug Bridge version 1.0.41
# Version 33.0.3-8952118
# 列出已连接设备
adb devices
# 预期输出格式：
# List of devices attached
# 0123456789ABCDEF device
- 若显示 `unauthorized`，需在设备上点击“允许USB调试”并勾选“始终允许”。
- 若设备未列出，检查USB线是否支持数据传输，或尝试更换USB端口。
##### 3.4.2 开发者选项关键开关
| 开关项 | 作用 | 建议值 |
|--------|------|--------|
| USB调试 | 允许adb命令控制设备 | 开启，勾选“总是允许” |
| 保持唤醒状态 | 充电时屏幕不锁屏，避免中断录制 | 开启 |
| 强制GPU渲染 | 使用GPU进行2D绘制，降低CPU负载 | 调试时开启，发布时关闭 |
| 显示GPU过度绘制 | 可视化不同区域的绘制次数 | 调试UI性能时开启 |
| 不保留活动 | 后台Activity立刻销毁，模拟弱内存场景 | 按需开启 |
| 动画缩放 | 窗口/过渡/动画时长缩放 | 全部设置为0.5x或关闭 |
> 注意：动画缩放设置为0.5x在录制帧率时能减少UI动画对性能数据的扰动，但最终测试仍应以实际用户设置（1x）为准。
##### 3.4.3 PerfDog安装与设备连接
1. **下载与安装**：访问PerfDog官网，下载对应操作系统版本。macOS下将.app拖入Applications目录；Windows下解压运行exe。
2. **授权录制权限**（Android 10及以上）：adb shell settings put global development_settings_enabled 1 开启远程调试权限后，PerfDog会自动请求授权。
3. **连接设备**：
- USB连接后，打开PerfDog，点击“连接设备”按钮，选择已识别的设备。
- 若使用Wi-Fi调试：adb tcpip 5555 → adb connect 192.168.x.x:5555。
# 开启Wi-Fi调试（设备需先USB连接一次）
adb tcpip 5555
adb connect 192.168.1.100:5555
# 验证连接
adb devices
# 输出应包含 192.168.1.100:5555 device
# 断开Wi-Fi调试
adb disconnect 192.168.1.100:5555
##### 3.4.4 Profiler远端调试配置（以Unity为例）
Unity Profiler通过adb forward将设备端数据端口映射到本地：
# 查询设备端Profiler服务端口（通常为34999）
adb forward tcp:34999 tcp:34999
# 或使用动态端口
adb forward tcp:0 tcp:34999
# 查看已建立的转发规则
adb forward --list
# 输出示例：
# 0123456789ABCDEF tcp:34999 tcp:34999
在Unity Editor中：
- 打开Window → Analysis → Profiler。
- 点击“Record”，选择“Remote Device”，键入设备IP:端口（如127.0.0.1:34999）。
- 点击“Connect”，观察Profiler数据是否开始刷新。
##### 3.4.5 常见错误与解决方案
| 错误表现 | 根本原因 | 解决方案 |
|----------|----------|----------|
| `adb devices` 显示 `unauthorized` | 设备未授权本机RSA指纹 | 拔掉USB重连，点击“允许USB调试” |
| PerfDog无法识别设备 | 缺少adb驱动或设备被其他进程占用 | 关闭第三方手机助手，安装官方驱动 |
| Profiler数据不更新 | adb forward端口冲突或服务未启动 | adb kill-server后重新adb forward |
| 帧率数据剧烈抖动 | 动画缩放未关闭或设备散热过差 | 关闭“动画缩放”并让设备冷却5分钟 |
#### 3.5 实用检查清单
在开始任何帧率测试前，建议执行以下快速验证：
- [ ] adb devices 显示目标设备为 `device` 状态
- [ ] PerfDog 录制按钮可点击，帧数曲线持续更新
- [ ] 开发者选项中“保持唤醒状态”已开启
- [ ] 动画缩放均设置为0.5x或关闭
- [ ] Profiler 远端连接无超时或断流
- [ ] 设备电池电量在30%以上（避免触发降频）
#### 3.6 性能与稳定性优化建议
1. **减少USB线干扰**：使用长度不超过1.5m的屏蔽USB线；优先使用主板原生USB 3.0接口，避免通过USB Hub。
2. **隔离后台进程**：在测试前使用 `adb shell am force-stop` 关闭非必要应用，降低系统负载噪声。
3. **固定设备温度**：将设备置于金属散热底座上，或使用风扇降温；记录测试开始/结束时的电池温度。
4. **持久化adb转发**：在Profiler配置中设置脚本自动执行adb forward，避免每次测试手动输入。
# Windows批处理：自动设置adb转发
@echo off
adb kill-server
adb start-server
adb wait-for-device
adb forward tcp:34999 tcp:34999
echo adb forward established
pause
> 提示：在连续录制20分钟以上的长周期测试中，建议每30秒记录一次设备温度和帧率均值，便于后续抖动分析时剔除温度触发的降频片段。