鸿蒙设备开发：HiLog日志系统详解与实践

1. 鸿蒙设备开发中的日志打印基础

在鸿蒙设备开发过程中，日志打印是最基础也是最重要的调试手段之一。不同于PC端开发可以直接使用printf输出调试信息，鸿蒙设备开发需要使用专门的HiLog接口进行日志记录。这个设计背后有几个关键考量：

首先，鸿蒙设备通常资源有限，直接使用标准输出会占用过多系统资源。HiLog采用缓冲区机制，可以有效控制日志输出的内存占用。其次，鸿蒙系统需要支持多设备协同，统一的日志接口便于日志收集和分析。最后，HiLog提供了日志分级功能，可以根据不同场景灵活控制日志输出量。

提示：在实际开发中，建议从项目初期就规划好日志策略，避免后期调试时才发现日志不足或过多的问题。

1.1 HiLog的基本使用方式

HiLog的使用包含三个核心要素：Domain、Tag和日志级别。Domain用于标识功能模块，通常建议使用反向域名规则，如"com.example.myapp"。Tag则是更具体的标识，可以是类名或功能名。日志级别从DEBUG到FATAL共分6级：

c复制#include "hilog/log.h"

#undef LOG_DOMAIN
#undef LOG_TAG
#define LOG_DOMAIN 0x0020  // 自定义domain值
#define LOG_TAG "MY_MODULE"

void sample_function() {
    HILOG_DEBUG(LOG_APP, "This is a debug message");
    HILOG_INFO(LOG_APP, "Process started with param=%d", 42);
    HILOG_WARN(LOG_APP, "Unexpected condition occurred");
    HILOG_ERROR(LOG_APP, "Operation failed with code %d", errCode);
}

在实际项目中，我习惯将日志宏定义封装在单独的头文件中，方便统一管理和修改。例如：

c复制// log_utils.h
#pragma once
#include "hilog/log.h"

#define MY_LOG_DEBUG(fmt, ...) HILOG_DEBUG(LOG_APP, fmt, ##__VA_ARGS__)
#define MY_LOG_INFO(fmt, ...)  HILOG_INFO(LOG_APP, fmt, ##__VA_ARGS__)
// ...其他级别日志宏

这种封装方式有两个好处：一是可以统一修改日志格式或行为；二是当需要替换日志系统时，只需修改这个头文件即可。

2. 工程创建中的日志配置

2.1 工程配置文件调整

在创建鸿蒙设备开发工程时，需要在build.gn文件中添加对HiLog的依赖。对于不同的设备类型，配置方式略有差异：

gn复制# 对于轻量系统(LiteOS-M)
deps = [
    "//base/hiviewdfx/hilog/log/native:libhilog",
]

# 对于小型系统(LiteOS-A)
deps = [
    "//base/hiviewdfx/hilog/log/full:libhilog",
]

在bundle.json中，还需要声明日志权限：

json复制{
  "abilities": [
    {
      "permissions": [
        "ohos.permission.READ_LOGS",
        "ohos.permission.