3. HAL层日志打印：ALOGV/ALOGD/ALOGI/ALOGW/ALOGE宏的使用、条件日志、日志缓冲区

在Camera HAL层开发中，日志系统是调试和问题定位的核心工具。Android系统为HAL层提供了基于log/log.h的日志宏，这些宏封装了内核logd守护进程的写入接口。本章将深入解析ALOG系列宏的差异、条件日志的编译优化技巧以及日志缓冲区的配置与读取方法。

3.1 ALOG系列宏：等级与行为

Android日志系统定义了五个优先级，从低到高分别为：VERBOSE、DEBUG、INFO、WARN、ERROR。HAL层通过ALOGV、ALOGD、ALOGI、ALOGW、ALOGE宏输出对应等级的日志。

3.2 条件日志：编译期与运行期控制

条件日志是HAL层性能优化的关键手段。通过编译期宏和运行期属性双重控制，可以在不修改代码的情况下切换日志详细程度。

3.2.1 编译期控制：LOG_NDEBUG

在Android.mk或Android.bp中定义LOG_NDEBUG可全局关闭ALOGV/ALOGD输出。HAL模块通常按文件或目录粒度控制：

// Android.bp 示例：仅关闭特定文件的VERBOSE日志
cc_library_shared {
    name: "camera.device@3.4-impl",
    cflags: [
        "-DLOG_NDEBUG=1",          // 关闭ALOGV/ALOGD
        "-DCAMERA_DEBUG_FRAME=1",  // 保留帧级调试宏
    ],
    srcs: ["CameraDevice.cpp", "FrameProcessor.cpp"],
}

3.2.2 运行期动态控制：property + 自定义宏

生产版本中，通过系统属性动态开启特定模块的调试日志：

// 自定义条件日志宏
#define CAMERA_LOGV(tag, fmt, ...)                     \
    do {                                                \
        if (__builtin_expect(                          \
            property_get_bool("persist.camera.logv", 0), 0)) { \
            ALOGV("[%s] " fmt, tag, ##__VA_ARGS__);    \
        }                                               \
    } while (0)

// 使用示例
CAMERA_LOGV("ISP", "AE stats: r=%d g=%d b=%d", r, g, b);

3.3 日志缓冲区：配置、读取与监控

Android日志系统使用内核环形缓冲区（ring buffer）存储日志。HAL层日志写入logd后，根据log tag和优先级分发到不同的缓冲区。Camera HAL日志通常出现在main和system缓冲区中。

3.3.1 缓冲区类型与大小

3.3.2 调整缓冲区大小

在调试高帧率Camera HAL时，默认256KB缓冲区极易被ALOGV日志填满，导致早期日志被覆盖。可通过以下方式调整：

# 通过adb设置（重启失效）
adb logcat -G 2M          # 将所有缓冲区设为2MB
adb logcat -G 4M main     # 仅将main缓冲区设为4MB

# 通过build.prop持久化
persist.logd.size.main=4M
persist.logd.size.system=2M
persist.logd.size.crash=1M

3.3.3 读取与过滤HAL日志

Camera HAL日志的典型读取方式：

# 实时过滤Camera HAL日志
adb logcat -v threadtime -b main -b system | grep -E "CameraService|CameraHAL|camera3"

# 保存到文件并分析
adb logcat -d -b main -b system -f /data/local/tmp/hal_log.txt

# 使用logcat的tag过滤（推荐）
adb logcat -s "CameraHAL:I" "*:W"   # 只显示CameraHAL的INFO及以上，其他模块WARN及以上

3.4 最佳实践与常见陷阱

• 避免在互斥锁内打印日志：ALOG宏可能触发文件描述符操作，在持有锁时调用可能导致死锁或优先级反转。
• 使用__func__定位代码位置：在日志中包含函数名，便于快速定位：ALOGE("%s: buffer handle is null", __func__);
• 警惕日志丢失：当ALOGV日志产生速率超过logd写入能力时，日志会被静默丢弃。可通过logcat -b events | grep "logd"查看丢日志统计。
• 不要在生产版本中保留ALOGV：即使条件日志关闭了输出，参数计算和字符串格式化仍会产生CPU开销。使用#if LOG_NDEBUG完全移除。