4. logcat 工具详解：命令行参数、过滤日志、保存日志到文件、实时查看日志

在 Camera HAL 开发与调试过程中，logcat 是 Android 平台最核心的日志输出工具。HAL 层通过 ALOGE、ALOGW、ALOGI、ALOGD、ALOGV 宏输出的日志，全部经由 logcat 统一收集与呈现。掌握 logcat 的命令行参数、过滤机制、文件保存与实时查看技巧，是 HAL 调试的基本功。

4.1 logcat 命令行参数全景

logcat 命令的基本语法为：

adb logcat [<option>] ... [<filter-spec>] ...

以下表格列出了 Camera HAL 调试中最常用的 logcat 参数：

adb logcat -v threadtime -s CameraHal:* CameraHAL:* HAL:*

4.2 日志过滤：从海量信息中精准定位

Android 日志系统按标签（TAG）和优先级（Priority）两级过滤。优先级从低到高依次为：

• V (Verbose) — 最详细，通常只在开发阶段开启
• D (Debug) — 调试信息，HAL 层 ALOGD 输出
• I (Info) — 常规信息，HAL 层 ALOGI 输出
• W (Warning) — 警告，HAL 层 ALOGW 输出
• E (Error) — 错误，HAL 层 ALOGE 输出
• F (Fatal) — 致命错误
• S (Silent) — 静默，不输出任何日志

过滤语法为：<TAG>:<PRIORITY>。多个过滤规则用空格分隔。

# 仅显示 CameraHal 标签的 Error 及以上级别日志
adb logcat -s CameraHal:E

# 显示 CameraHal 的 Debug 及以上 + 所有 Error 级别日志
adb logcat CameraHal:D *:E

# 显示多个 HAL 相关标签
adb logcat -s CameraHal:V CameraHAL:V HAL:V

4.3 保存日志到文件：持久化分析

Camera HAL 调试往往需要长时间抓取日志，或在不同设备间传输日志。logcat 提供了多种保存方式：

4.3.1 重定向到 PC 端文件

# 将日志实时写入 PC 文件（Ctrl+C 停止）
adb logcat -v threadtime -s CameraHal:* > camera_hal_log.txt

# 使用 tee 同时查看和保存
adb logcat -v threadtime -s CameraHal:* | tee camera_hal_log.txt

4.3.2 使用 logcat 内置文件保存（设备端）

# 在设备端保存日志，每 512KB 轮转，保留 3 个文件
adb logcat -v threadtime -f /data/local/tmp/camera_hal.log -r 512 -n 3 -s CameraHal:*

4.3.3 一次性 dump 保存

# 获取当前所有日志并保存
adb logcat -d -v threadtime -s CameraHal:* > camera_hal_dump.txt

4.4 实时查看日志：动态跟踪 HAL 行为

实时查看是 logcat 最常用的模式。在 Camera HAL 调试中，实时日志可以帮助开发者观察帧率、参数下发、错误恢复等动态行为。

4.4.1 基础实时查看

# 实时查看 CameraHal 日志
adb logcat -v threadtime -s CameraHal:*

4.4.2 带时间戳的实时查看

# 显示精确到毫秒的时间戳和线程 ID
adb logcat -v threadtime -s CameraHal:*

4.4.3 实时过滤 + 高亮

# 使用 grep 高亮 Error 级别日志
adb logcat -v threadtime -s CameraHal:* | grep --color=always -E "Error|ERROR|Fatal|FATAL"

4.4.4 实时查看特定进程

# 先获取 cameraserver 进程 PID
adb shell ps -A | grep cameraserver

# 实时查看该进程所有日志
adb logcat -v threadtime --pid=1234

adb logcat -v threadtime -s CameraHal:* CameraHAL:* HAL:* | tee hal_live.log

4.5 logcat 缓冲区与 Camera HAL 日志流向

Android 日志系统包含多个缓冲区，Camera HAL 日志默认写入 main 缓冲区。理解缓冲区结构有助于定位日志丢失问题。

4.6 高级过滤技巧：正则表达式与组合过滤

当 Camera HAL 日志量极大时，基础过滤可能不够用。以下高级技巧可以进一步提升过滤精度：

4.7 Camera HAL 调试日志实战案例

以下是一个完整的 Camera HAL 调试日志抓取流程：

1. 清空缓冲区：adb logcat -c
2. 启动实时日志并保存：adb logcat -v threadtime -s CameraHal:* CameraHAL:* | tee /tmp/hal_debug.log
3. 复现 Camera 问题：打开相机 App，执行导致问题的操作
4. 停止日志：Ctrl+C
5. 分析日志：

   # 提取所有 Error 级别日志
   grep " E " /tmp/hal_debug.log > errors.log
   
   # 提取与 stream 配置相关的日志
   grep -i "stream\|configure_streams" /tmp/hal_debug.log > stream_config.log
   
   # 统计各 TAG 出现次数
   grep -oP "^\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3}\s+\d+\s+\d+\s+\w+\s+(\w+)" /tmp/hal_debug.log | sort | uniq -c | sort -rn

4.8 logcat 常见问题与解决方案