📚 课程目录第2章调试环境搭建

调试环境搭建：adb 命令行工具、Android Studio Profiler、WorkManager Inspection 面板配置

2.1 问题排查主线映射

调试环境搭建是问题排查的数据采集基础。本章围绕“现象识别→数据采集→原因定位→修复动作→复测→预防”主线，将三个工具分别对应到关键环节：

排查环节	adb 命令行	Android Studio Profiler	WorkManager Inspection
现象识别	实时日志过滤 Worker 状态、约束变化	查看 CPU/内存/网络波动	观察 Worker 生命周期状态（ENQUEUED → RUNNING → SUCCESS/FAILED）
数据采集	拉取 logcat、dumpsys jobscheduler、battery stats	录制性能 Trace、Heap Dump	导出全部 WorkInfo、Worker 链式依赖图
原因定位	匹配错误堆栈与 Worker 日志 Tag	分析卡顿、内存泄漏与 Worker 执行间隔	查看失败原因、约束失效、延迟触发
修复动作	修改代码后快速重装包、清除 WorkManager 数据库	针对 CPU/内存问题优化 Worker 逻辑	调整约束、重试策略、背压参数
复测	adb shell am broadcast 触发一次性 Worker	再次录制对比 Trace 差异	观察新配置下 Worker 调度是否正常
预防	编写自动化 logcat 解析脚本	建立性能基线，定期 Profiler 检查	添加 Inspection 面板预检查点

2.2 adb 命令行工具配置与常用排查命令

2.2.1 环境确认

确保 adb 已加入 PATH，版本 ≥ 1.0.41：

adb version
# 输出示例：
# Android Debug Bridge version 1.0.41
# Version 34.0.4-10487297

连接设备或模拟器后执行 adb devices 确认状态为 device。

2.2.2 核心排查命令清单

实时过滤 Worker 日志：
```
adb logcat -v time WORKER_TAG:V *:S
```

查看所有 WorkManager 状态：

adb shell dumpsys jobscheduler | grep -A 10 "com.your.package"

强制触发一次性 Work：

adb shell am broadcast -a "com.your.package.TRIGGER_WORK" --es work_name "myWorker"

（需在 App 内注册动态广播）

清除 WorkManager 数据库（重置状态，慎用）：
```
adb shell pm clear com.your.package
```

判断规则：若在 dumpsys 输出中看到 Waiting: true 且 Ready: false，说明 Worker 因约束（如网络、电量）被挂起；优先检查约束配置。

2.3 Android Studio Profiler 配置与监控点

2.3.1 启用方式

Android Studio → View → Tool Windows → Profiler
选择部署的设备/进程。
切换到“CPU”、“Memory”、“Network”标签，建议同时录制“System Trace”以查看 Thread 调度。

2.3.2 Worker 执行关键指标

指标	正常范围	异常信号
Worker 线程 CPU 占用	< 20% 持续 2s	> 60% 且持续 > 5s → 可能死循环
内存分配频率	无明显锯齿	频繁 GC → Worker 创建过多临时对象
网络请求时长	< 3s	> 10s 或超时 → 检查约束与线程池

2.4 WorkManager Inspection 面板配置与使用

2.4.1 打开 Inspection 面板

Android Studio 4.1+ 内置 WorkManager Inspector：

View → Tool Windows → App Inspection → WorkManager Inspector

首次使用需等待面板加载（若不可见，检查 Gradle 依赖是否包含 androidx.work:work-runtime-ktx:2.9.0+）。

2.4.2 面板核心操作

Worker 列表：按状态（ENQUEUED / RUNNING / SUCCEEDED / FAILED / CANCELLED）筛选。
点击单个 Worker：查看约束、重试次数、下次执行时间、传递的数据。
强制触发/取消：右键 Worker 选择“Run Now”或“Cancel”。
导出数据库快照：点击“Export”按钮，可分析 WorkSpec、WorkProgress、WorkTag 等表。

排查技巧：当 Worker 状态显示“BLOCKED”时，检查该 Worker 是否依赖的 previousWorker 尚未完成，或约束（如 NetworkType.CONNECTED）一直不满足。Inspection 面板会高亮显示依赖关系。

2.5 调试环境协作架构（SVG）

2.6 环境验证清单（复测环节）

完成配置后，按以下清单验证三个工具能否协同工作：

adb ≥ 1.0.41：adb shell echo "OK" 返回 OK
Profiler 可录制 30s 以上 Trace：选择 CPU 标签 → “Record” → 等待 30s → 停止，确认出现火焰图
Inspection 面板显示至少一个 Worker：在 App 内调用 WorkManager.enqueue()，面板应秒级刷新出 ENQUEUED 状态
连通性测试：在 Inspection 面板点击“Run Now”，同时用 adb logcat 过滤 Workers 日志，应看到对应 Worker 的 onStartJob 调用

常见陷阱：如果 Inspection 面板一直显示“No Workers”，但代码已调用 enqueue，检查应用是否处于 debuggable 模式（build.gradle 中 debuggable true）。模拟器需要 API 26+。adb 命令若提示“device unauthorized”，请重新授权 USB 调试。