harmony 鸿蒙HiLog开发指导

2022-08-09
浏览 (1702)

HiLog开发指导

概述

HiLog是OpenHarmony日志系统，提供给系统框架、服务、以及应用打印日志，记录用户操作、系统运行状态等。

本章节内容对标准系统类设备（参考内存≥128MiB）适用。

接口说明

表1 C++、C的函数接口

C++		C
类	方法	方法/宏
HiLog	int Debug(const HiLogLabel &label, const char *fmt, …)	HILOG_DEBUG(type, …)
	int Info(const HiLogLabel &label, const char *fmt, …)	HILOG_INFO(type, …)
	int Warn(const HiLogLabel &label, const char *fmt, …)	HILOG_WARN(type, …)
	int Error(const HiLogLabel &label, const char *fmt, …)	HILOG_ERROR(type, …)
	int Fatal(const HiLogLabel &label, const char *fmt, …)	HILOG_FATAL(type, …)
	NA	int HiLogPrint(LogType type, LogLevel level, unsigned int domain, const char tag, const char fmt, …)
	boolean IsLoggable(unsigned int domain, const char *tag, LogLevel level)	bool HiLogIsLoggable(unsigned int domain, const char *tag, LogLevel level)
HiLogLabel	struct HiLogLabel	LOG_DOMAIN LOG_TAG

表2 C++接口说明函数参数和功能

类	方法	描述
HiLog	int Debug(const HiLogLabel &label, const char *fmt, …)	功能：输出 debug 级别日志。输入参数： - label：用于标识输出日志的类型、业务领域、TAG。 - format：常量格式字符串，包含参数类型、隐私标识。未加隐私标识的缺省为隐私参数。 - fmt：格式化变参描述字符串。输出参数：无返回值：大于等于0，成功；小于0，失败。
	int Info(const HiLogLabel &label, const char *fmt, …)	功能：输出 info 级别日志。参数说明同 Debug 接口。
	int Warn(const HiLogLabel &label, const char *fmt, …)	功能：输出 warn 级别日志。参数说明同 Debug 接口。
	int Error(const HiLogLabel &label, const char *fmt, …)	功能：输出 error 级别日志。参数说明同 Debug 接口。
	int Fatal(const HiLogLabel &label, const char *fmt, …)	功能：输出 fatal 级别日志。参数说明同 Debug 接口。
	boolean IsLoggable(unsigned int domain, const char *tag, LogLevel level)	功能：检查指定业务领域、TAG、级别的日志是否可以打印。输入参数： - domain：指定日志业务领域。 - tag: 指定日志TAG。 - level: 指定日志level。输出参数：无返回值：如果指定domain、tag、level日志可以打印则返回true；否则返回false。
HiLogLabel	struct HiLogLabel	功能：初始化日志标签参数。成员参数： - type: 指定日志type。 - domain：指定日志业务领域。 - tag: 指定日志TAG。

开发实例

C使用示例

在.c源文件中，包含hilog头文件：

   #include "hilog/log.h"

 定义domain、tag：

   #undef LOG_DOMAIN
   #undef LOG_TAG
   #define LOG_DOMAIN 0xD003200  // 标识业务领域，范围0xD000000~0xD0FFFFF
   #define LOG_TAG "MY_TAG"

 打印日志：

   HILOG_INFO(LOG_CORE, "Failed to visit %{private}s, reason:%{public}d.", url, errno);

编译设置，在BUILD.gn里增加子系统SDK依赖：

   external_deps = [ "hilog:libhilog" ]

C++使用示例

在.h类定义头文件中，包含hilog头文件：

   #include "hilog/log.h"

 如果类头文件中需要日志打印，在头文件中类定义起始处 定义 LABEL：

   class MyClass {
   static constexpr OHOS::HiviewDFX::HiLogLabel LABEL = {LOG_CORE, 0xD003200, "MY_TAG"}; 
   ......
   }

 如果类头文件中没有日志打印，在类实现文件中 定义 LABEL：

   using namespace OHOS::HiviewDFX;
   static constexpr HiLogLabel LABEL = {LOG_CORE, 0xD003200, "MY_TAG"};

 打印日志：

   HiLog::Info(LABEL, "Failed to visit %{private}s, reason:%{public}d.", url, errno);

编译设置，在BUILD.gn里增加子系统SDK依赖：

   external_deps = [ "hiviewdfx:libhilog" ]

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkCompiler开发指导

harmony 鸿蒙窗口标题栏定制开发指导

0 赞

所属分类： 后端技术
本文标签： 软件鸿蒙
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/f91f11ede0e74a91aa0cf98624807609

harmony 鸿蒙HiLog开发指导

HiLog开发指导

概述

接口说明

开发实例

C使用示例

C++使用示例

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录