harmony 鸿蒙HiLog开发指导

  • 2022-08-09
  • 浏览 (1700)

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使用示例

  1. 在.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);
  1. 编译设置,在BUILD.gn里增加子系统SDK依赖:
   external_deps = [ "hilog:libhilog" ]

C++使用示例

  1. 在.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);
  1. 编译设置,在BUILD.gn里增加子系统SDK依赖:
   external_deps = [ "hiviewdfx:libhilog" ]

你可能感兴趣的鸿蒙文章

harmony 鸿蒙子系统开发

harmony 鸿蒙AI框架开发指导

harmony 鸿蒙NNRt接入适配指导

harmony 鸿蒙应用特权配置指南

harmony 鸿蒙开发实例

harmony 鸿蒙搭建环境

harmony 鸿蒙开发指导

harmony 鸿蒙概述

harmony 鸿蒙ArkCompiler开发指导

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

0  赞