小米设备使用 Android Performance Analyzer 的配置与排障记录
最近在学习 Android Performance Analyzer（APA），准备通过它来录制和分析 Android 应用的性能数据。第一次接入时，我使用的是小米设备，结果在初始化阶段遇到了一些连接和安装相关的问题。
这篇文章记录一次完整的排障过程：从开启开发者选项，到处理小米 / HyperOS 对 USB 安装、ADB 调试和系统安全扫描的限制，最后让 APA 成功识别设备并开始录制 Trace。
问题现象
电脑端已经能通过 USB 连接到手机，但 APA 在初始化设备时失败，常见现象包括：
- APA 页面提示
Unknown error。 - 初始化阶段卡在
Loading APKs。 - 点击
Retry后仍然失败。
这类问题通常不是 APA 本身无法使用，而是小米系统对 ADB 安装、USB 调试权限和安全扫描做了额外限制。APA 初始化时需要向手机推送并安装测试 APK，因此必须先放开这些权限。
第一步：开启开发者选项和 USB 调试
先完成 Android 调试的基础配置：
- 打开手机的 设置。
- 进入 我的设备 -> 全部参数与信息。
- 连续点击 MIUI 版本 或 HyperOS 版本 7 次，直到系统提示已经开启开发者选项。
- 返回设置页，进入 更多设置 -> 开发者选项。
- 打开 USB 调试。
完成这一步后，手机已经具备基础 ADB 调试能力，但对小米设备来说，这通常还不够。
第二步：开启小米设备的关键调试权限
APA 初始化时需要安装辅助 APK。如果这里没有放开权限，就很容易出现 Loading APKs 失败。
在 开发者选项 中继续开启下面两个选项。
开启 USB 安装
打开 USB 安装，允许电脑通过 USB 向手机安装应用。
需要注意：
- 通常需要登录小米账号。
- 手机需要插入 SIM 卡。
- 开启过程中会弹出安全警告，需要按提示全部允许。
开启 USB 调试（安全设置）
打开 USB 调试（安全设置），允许通过 ADB 执行更高权限的模拟点击和系统管理命令。
开启时系统可能会连续弹出风险提示，每次都有倒计时。按提示点击 下一步 并确认即可。
第三步：关闭系统级干扰
如果已经开启上面的权限，APA 仍然初始化失败，可以继续检查小米系统的安全策略。
关闭 MIUI / HyperOS 优化
在 开发者选项 的底部找到 启用 系统 优化 或类似选项，并将其关闭。
关闭后，系统会更接近原生 Android 的安装逻辑，可以减少小米系统对调试安装过程的额外拦截。
如果找不到这个开关，可以尝试在 开发者选项 底部连续点击 恢复默认设置 4 到 5 次。部分系统版本中，这个隐藏开关会在连续点击后显示出来。显示后将其关闭，并重启手机。
关闭安全中心的 USB 安装扫描
小米的安全中心也可能拦截通过 USB 安装的应用。可以按下面路径关闭相关扫描：
- 打开手机自带的 安全中心 App。
- 点击右上角 设置 图标。
- 进入 安全扫描。
- 关闭 监控通过 USB 安装的应用。
这一步可以避免 APA 推送辅助 APK 时被系统安全扫描流程拦截。
第四步：重置 ADB 连接
权限调整完成后，建议重启 ADB 服务，清理可能卡住的连接状态。
在电脑命令行执行：
adb kill-server
adb start-server
然后重新拔插 USB 数据线，回到 APA 界面点击 Retry。
成功标志
如果配置成功，APA 中的设备名称旁边会出现绿色勾选标记，底部的 OK 按钮也会恢复为可点击状态。
这时就说明设备初始化已经完成，可以开始录制 Trace 了。
排障 checklist
如果仍然失败，可以按下面顺序快速检查：
- 手机是否已经开启 USB 调试。
- 是否开启 USB 安装。
- 是否开启 USB 调试（安全设置）。
- 点击
Retry时手机是否保持解锁。 - 是否及时允许了手机端弹出的 USB 安装确认框。
- 是否关闭了 MIUI / HyperOS 优化。
- 是否关闭了安全中心里的 监控通过 USB 安装的应用。
- 是否执行过
adb kill-server和adb start-server。 - 是否重新插拔过 USB 数据线。
总结
小米设备使用 APA 的主要问题，通常集中在系统安全策略上。APA 需要通过 ADB 推送并安装测试 APK，而小米 / HyperOS 会对 USB 安装、ADB 高权限操作和安全扫描做多层拦截。
因此，排障的核心思路是：
- 先确认基础 ADB 调试可用。
- 再开启小米专属的 USB 安装和安全调试权限。
- 最后关闭可能干扰 APK 安装的系统优化和安全扫描。
完成这些配置后，APA 就可以正常识别小米设备，并进入后续的性能录制和分析流程。
