LoomSDK中的原生日志系统详解：C++日志记录指南

前言

在软件开发过程中，日志系统是开发者调试和监控程序运行状态的重要工具。LoomSDK提供了一套轻量级但功能完备的原生日志框架，专门为C++开发者设计。本文将深入解析这套日志系统的使用方法、核心概念和高级功能。

日志系统概述

LoomSDK的日志系统基于"日志组"(log group)的概念设计，每个日志组包含以下属性：

• 组名称(用于标识和显示)
• 启用开关(控制是否输出日志)
• 过滤级别(控制输出日志的严重程度)

这种设计使得开发者可以精细控制不同模块的日志输出，在调试和生产环境中灵活切换。

基础使用

定义日志组

在全局作用域中使用lmDefineLogGroup宏定义日志组：

#include "loom/common/core/log.h"

lmDefineLogGroup(loom_asset, "loom.asset", 1, LoomLogWarn);

参数解析：

1. 变量名：定义日志组的变量名(此处为loom_asset)
2. 显示名：日志输出时显示的名称(此处为"loom.asset")
3. 启用开关：1表示启用，0表示禁用
4. 默认过滤级别：控制显示的最低日志级别

日志级别说明

LoomSDK定义了以下日志级别(从低到高)：

• LoomLogDebug：调试信息，最详细
• LoomLogInfo/LoomLogDefault：常规信息
• LoomLogWarn：警告信息
• LoomLogError/LoomLogMax：错误信息

跨文件共享日志组

当需要在多个文件中使用同一个日志组时：

1. 在一个源文件中定义：

lmDefineLogGroup(shared_group, "shared.group", 1, LoomLogInfo);

2. 在其他文件中声明：

lmDeclareLogGroup(shared_group);

日志记录实践

基本日志输出

使用以下宏记录日志：

• lmLogDebug：调试信息
• lmLogInfo/lmLog：常规信息
• lmLogWarn：警告
• lmLogError：错误

示例：

lmLog(myGroup, "系统初始化完成");  // 等同于lmLogInfo
lmLogError(myGroup, "文件加载失败");

格式化输出

支持类似printf的格式化语法：

int retryCount = 3;
float progress = 0.75f;
lmLogDebug(myGroup, "重试次数: %d, 进度: %.2f%%", retryCount, progress * 100);

高级配置

动态配置日志规则

运行时动态修改日志行为：

// 启用"myapp.network"组，只显示错误及以上级别
loom_log_addRule("myapp.network", 1, LoomLogError);

这种配置特别适合在生产环境中关闭调试日志，只保留关键错误信息。

自定义日志处理器

通过回调机制将日志输出到自定义目标(如文件、网络等)：

void customLogger(void* payload, loom_logGroup_t* group, 
                 loom_logLevel_t level, const char* msg) {
    // 示例：将错误日志写入文件
    if (level >= LoomLogError) {
        FILE* logFile = (FILE*)payload;
        fprintf(logFile, "[ERROR] %s: %s\n", group->name, msg);
    }
}

// 注册回调
FILE* errorLog = fopen("errors.log", "a");
loom_log_addListener(&customLogger, errorLog);

// 使用后移除回调
loom_log_removeListener(&customLogger, errorLog);
fclose(errorLog);

最佳实践建议

1. 合理划分日志组：按功能模块划分(如network、asset、ui等)
2. 生产环境配置：默认关闭Debug日志，只开启Error级别
3. 敏感信息处理：避免在日志中记录密码等敏感信息
4. 性能考量：高频日志使用Debug级别，减少生产环境开销
5. 日志格式统一：团队约定统一的日志格式规范

总结

LoomSDK的原生日志系统提供了从简单到高级的完整日志解决方案。通过日志组的概念，开发者可以精细控制不同模块的日志输出；格式化输出和回调机制则提供了足够的灵活性。合理使用这套系统将显著提升开发效率和运行时问题诊断能力。

对于大型项目，建议结合本文介绍的高级功能，构建适合项目需求的日志收集和分析体系，这将为项目的长期维护打下良好基础。