HarmonyOS API：HiLog

版本：v3.1 Beta

HiLog

更新时间: 2023-02-17 09:19

HiLog模块实现日志打印功能。

开发者可以通过使用这些接口实现日志相关功能，输出日志时可以指定日志类型、所属业务领域、日志TAG标识、日志级别等。

@syscap SystemCapability.HiviewDFX.HiLog

起始版本：

8

汇总

文件

宏定义

枚举

函数

详细描述

宏定义说明

LOG_DOMAIN

#define

描述：

日志所对应的业务领域，用于标识业务的子系统、模块。

16进制整数，有效范围0x0~0xFFFF，超过自动截掉高位。

起始版本：

8

LOG_TAG

#define

描述：

字符串常量，标识调用所在的类或者业务。

起始版本：

8

OH_LOG_DEBUG

#define OH_LOG_DEBUG( type,  ... )   ((void)OH_LOG_Print((type), LOG_DEBUG, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))

描述：

DEBUG级别写日志，宏封装接口。

使用时需要先定义日志业务领域、日志TAG，一般在源文件起始处统一定义一次。

参数：

参见：

​​OH_LOG_Print​​

起始版本：

8

OH_LOG_ERROR

#define OH_LOG_ERROR( type,  ... )   ((void)OH_LOG_Print((type), LOG_ERROR, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))

描述：

ERROR级别写日志，宏封装接口。

使用时需要先定义日志业务领域、日志TAG，一般在源文件起始处统一定义一次。

参数：

参见：

​​OH_LOG_Print​​

起始版本：

8

OH_LOG_FATAL

#define OH_LOG_FATAL( type,  ... )   ((void)HiLogPrint((type), LOG_FATAL, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))

描述：

FATAL级别写日志，宏封装接口。

使用时需要先定义日志业务领域、日志TAG，一般在源文件起始处统一定义一次。

参数：

参见：

​​OH_LOG_Print​​

起始版本：

8

OH_LOG_INFO

#define OH_LOG_INFO( type,  ... )   ((void)OH_LOG_Print((type), LOG_INFO, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))

描述：

INFO级别写日志，宏封装接口。

使用时需要先定义日志业务领域、日志TAG，一般在源文件起始处统一定义一次。

参数：

参见：

​​OH_LOG_Print​​

起始版本：

8

OH_LOG_WARN

#define OH_LOG_WARN( type,  ... )   ((void)OH_LOG_Print((type), LOG_WARN, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))

描述：

WARN级别写日志，宏封装接口。

使用时需要先定义日志业务领域、日志TAG，一般在源文件起始处统一定义一次。

参数：

参见：

​​OH_LOG_Print​​

起始版本：

8

枚举类型说明

LogLevel

enum LogLevel

描述：

日志级别。

该枚举类型用于定义日志级别。

各级别建议使用方式：

DEBUG：比INFO级别更详细的流程记录，通过该级别的日志可以更详细地分析业务流程和定位分析问题。DEBUG级别的日志在正式发布版本中默认不会被打印，只有在调试版本或打开调试开关的情况下才会打印。

INFO：用来记录业务关键流程节点，可以还原业务的主要运行过程；用来记录非正常情况信息，但这些情况都是可以预期的(如无网络信号、登录失败等)。这些日志都应该由该业务内处于支配地位的模块来记录，避免在多个被调用的模块或低级函数中重复记录。

WARN：发生了较为严重的非预期情况，但是对用户影响不大，程序可以自动恢复或通过简单的操作就可以恢复的问题。

ERROR：程序或功能发生了错误，该错误会影响功能的正常运行或用户的正常使用，可以恢复但恢复代价较高，如重置数据等。

FATAL：重大致命异常，表明程序或功能即将崩溃，故障无法恢复。

起始版本：

8

LogType

enum LogType

描述：

日志类型。

该枚举类型用于定义应用开发者可以使用的日志类型。当前有应用日志LOG_APP。

起始版本：

8

函数说明

OH_LOG_IsLoggable()

bool OH_LOG_IsLoggable (unsigned int domain, const char * tag, LogLevel level )

描述：

检查指定业务领域、TAG、级别的日志是否可以打印。

参数：

返回：

如果指定domain、tag、level日志可以打印则返回true；否则返回false。

起始版本：

8

OH_LOG_Print()

int OH_LOG_Print (LogType type, LogLevel level, unsigned int domain, const char * tag, const char * fmt,  ... )

描述：

写日志接口。

指定日志类型、日志级别、业务领域、TAG，按照类printf格式类型和隐私指示确定需要输出的变参。

参数：

返回：

大于等于0表示成功；小于0表示失败。

起始版本：

8

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/_hi_log-0000001447130392-V3?catalogVersion=V3#ZH-CN_TOPIC_0000001447130392__汇总​​