2. 调试环境搭建
大家好，我是你们的Camera系统工程师老K。今天咱们来聊聊调试环境搭建这件事。
说实话，我见过太多工程师一上来就急着抓log、改代码，结果环境没配好，折腾半天发现log根本不全，或者权限不够跑不起来。嗯，这就像你准备做饭，结果发现煤气灶没开——白忙活。
所以这一章，咱们把地基打牢。我会带着你一步步把调试环境搭好，保证后续的调试工作顺风顺水。
1. ADB与Fastboot：你的左膀右臂
先说说ADB和Fastboot。这两个工具，说白了就是你和设备之间的桥梁。
ADB（Android Debug Bridge） 负责设备开机后的调试，比如装APK、传文件、跑shell命令。而 Fastboot 是在bootloader阶段用的，刷机、解锁、烧写分区都靠它。
核心命令速查表
| 命令 | 用途 | 我的习惯 |
|---|---|---|
adb devices | 查看连接的设备 | 每次插线后先跑一遍，确认连接正常 |
adb shell | 进入设备shell | 我一般用 adb -s 设备号 shell 指定设备 |
adb logcat | 抓取日志 | 配合 -v time 显示时间戳 |
fastboot devices | 查看fastboot模式设备 | 刷机前必查，防止刷错设备 |
fastboot flash boot boot.img | 刷写boot分区 | 我常用它来替换内核 |
我个人习惯把ADB和Fastboot的路径加到系统环境变量里。这样在任何目录下都能直接敲命令，省得每次都要cd到工具目录。
小技巧： 如果你同时连着多台设备，用 adb -s 序列号 shell 指定设备。序列号可以通过 adb devices 看到。
2. root权限获取：没有root寸步难行
做Camera HAL层调试，root权限几乎是必须的。为什么？因为很多HAL层的节点、sysfs文件、甚至某些驱动接口，普通用户根本读不了。
我记得有一次调试一个Sensor的寄存器，死活读不到数据，折腾了两小时才发现是权限问题。从那以后，我拿到设备的第一件事就是root它。
获取root权限通常有几种方式：
- Magisk方案：目前最主流，支持systemless root，不影响OTA
- SuperSU方案：老牌工具，但已停止维护
- 工程固件：部分厂商提供带root的工程版本
我个人推荐Magisk。操作步骤大致如下：
- 解锁bootloader（
fastboot flashing unlock） - 提取原厂boot.img
- 用Magisk Manager修补boot.img
- 刷回修补后的boot.img（
fastboot flash boot magisk_patched.img）
注意： 解锁bootloader会清空设备数据。操作前一定做好备份。我曾经手滑把测试机里的数据全清了，那叫一个酸爽。
3. 关闭SELinux：别让它挡了你的路
SELinux，全称Security-Enhanced Linux。它的初衷是好的——加强系统安全。但在调试阶段，它经常成为绊脚石。
你想想看，你明明有root权限，但SELinux策略不允许你访问某个节点，log里只给你一句"Permission denied"。是不是很抓狂？
关闭SELinux有两种方式：
- 临时关闭：
setenforce 0，重启后恢复 - 永久关闭：修改内核启动参数，添加
androidboot.selinux=permissive
我一般用临时关闭的方式。调试完了再 setenforce 1 恢复，这样不影响设备的安全性。
验证SELinux状态：
# 查看当前模式
getenforce
# 输出示例
Enforcing # 表示开启
Permissive # 表示关闭（只记录不阻止）
Disabled # 表示完全禁用嗯，这里要注意：有些厂商的固件会限制 setenforce 命令的执行。如果遇到这种情况，你可能需要刷一个permissive的内核。
4. 开启Camera相关logcat日志
环境搭好了，权限也有了，接下来就是让系统把Camera相关的日志吐出来。
Camera HAL层的日志主要来自这几个地方：
- logcat主日志：包含HAL层、framework层的日志
- kernel日志（dmesg）：驱动层、ISP、Sensor的日志
- events日志：系统事件，比如Camera打开/关闭
我常用的logcat命令组合：
# 抓取所有Camera相关日志（实时）
adb logcat -v time | grep -iE "camera|hal|isp|sensor"
# 同时抓取kernel日志
adb shell dmesg -w | grep -iE "camera|isp|sensor" &
# 保存到文件，方便后续分析
adb logcat -v time -b all > camera_log_$(date +%Y%m%d_%H%M%S).txt我的经验： 调试时我习惯开三个终端窗口。一个跑logcat，一个跑dmesg，一个用来执行测试命令。这样日志不会乱，排查问题效率高很多。
另外，有些厂商会在HAL层里自定义log标签。比如高通平台常用 mm-camera，MTK平台用 mtk-camera。你可以先跑一遍 adb logcat -v time -b all | grep -i "camera"，看看实际打印的标签是什么，再针对性过滤。
5. 本章知识体系总览
说了这么多，咱们用一张图来总结一下。这张图展示了调试环境搭建的核心逻辑：从底层硬件到上层工具，每一层都有对应的调试手段。
这张图你看懂了吗？从上往下看，我们先用ADB/Fastboot连接设备，获取root权限，关闭SELinux，然后通过logcat和dmesg抓取日志。日志会从HAL层、内核层一直追溯到硬件层。说白了，调试就是一层层剥洋葱，找到问题根源。
本章核心要点：
- ADB和Fastboot是基础工具，务必熟练使用
- root权限是调试的入场券，推荐Magisk方案
- SELinux在调试阶段建议临时关闭，避免权限干扰
- logcat配合grep过滤Camera相关日志，效率翻倍
- 多窗口并行抓取日志，是资深工程师的标配操作
好了，环境搭建就讲到这里。下一章咱们会深入HAL层，看看怎么用这些工具去抓具体的Camera问题。到时候我会分享几个我实际项目中踩过的坑，保证让你少走弯路。
可可精品资料库