HarmonyOS NEXT 鸿蒙中手写和使用第三方仓库封装Logger打印工具

应用场景

        在鸿蒙开发中，我们在很多时候调试代码都需要用到日志打印工具，但无论是hilog还是console.log,都用起来相对麻烦，而且需要手动将对象转换为JSON字符串的方式才能打印，并且在控制台日志中输出的格式也非常丑。所以下面我们来自己封装一下Logger打印工具。

hilog和console.log的缺点

这是一个完整代码，复制即可使用测试hilog和console.log打印

import { hilog } from '@kit.PerformanceAnalysisKit'const DOMAIN = 0x0000;@Entry
@Component
struct Test {build() {Column() {Button('点击打印').onClick(() => {console.log('console.log打印值')hilog.info(DOMAIN, 'testTag', '%{public}s', 'hilog打印值');})}.width('100%').height('100%').justifyContent(FlexAlign.Center)}
}

 样式很简单，就一个按钮

可以在底部控制栏日志中查看打印

如果这样看好像也么啥，都能打印但是

hilog需要传入好几个参数才能打印自己想打印的那个参数

比如我就想打印个"123456"的字符串，前面需要配三个参数，很麻烦

而console.log不能单独打印对象，必须加上一个字符串类型

而且即使这样能打印，打印出来的也只是类型

必须把对象转为JSON格式的字符串才能打印具体值

基于hilog二次封装一个自己的logger工具

这个工具主要做了

1. 封装一个Logger工具类
2. 工具类提供一系列的方法(info, debug, error, warn)
3. 导出一个实例对象, 使用处通过实例对象调用方法

好处是将hilog中一些不需要改变的地方固定起来，使用的时候只需要传入要打印的东西即可，并且支持传入多个参数。

/*** 1. 封装一个Logger工具类* 2. 工具类提供一系列的方法(info, debug, error, warn)* 3. 导出一个实例对象, 使用处通过实例对象调用方法*/
import { hilog } from "@kit.PerformanceAnalysisKit";const PREFIX = 'utils_logger'class Logger {private domain: number;private prefix: string;private format: string = "%{public}s, %{public}s";constructor(domain: number, prefix: string) {this.domain = domainthis.prefix = prefix}debug(...args: string[]): void {hilog.debug(this.domain, this.prefix, this.format, args);}info(...args: string[]): void {hilog.info(this.domain, this.prefix, this.format, args);}warn(...args: string[]): void {hilog.warn(this.domain, this.prefix, this.format, args);}error(...args: string[]): void {hilog.error(this.domain, this.prefix, this.format, args);}
}export const logger = new Logger(0x1234, PREFIX)

现在在页面中使用试试

打印结果是

现在可以只传想打印的东西，不过也还有缺点，就是还是需要手动将对象转换为JSON

基于第三方库 @abner/log 封装Logger工具

这个第三方工具好用而且可视化效果很好。

在终端引入三方库

ohpm install @abner/log

初始化并导出

import { Log } from '@abner/log'// 初始化
Log.init({tag: "log_find_easy",domain: 0x0101,close: false,isHilog: true,showLogLocation: true,logSize: 1024
})export { Log }

 这是相关属性的解释

属性	类型	概述
tag	string	打印的标签，默认为： HarmonyOSLog
domain	number	输出日志所对应的业务领域,默认为0x0000
close	boolean	是否关闭打印，默认true为打开，false为不打印
isHilog	boolean	打印类型，默认为true是hilog打印 ，false为console
mShowLogLocation	boolean	是否展示点击的位置，默认为true是展示 ，false为不展示
logSize	number	日志每次输出大小，最大1024字节

 在页面中引入使用

打印结果，可以看到，非常的美观，并且对象也是格式化后的，还能把报错的具体位置给显示出来，真的是非常方便。

 试用

把下面三个文件放到同一个目录，并在终端通过ohpm install @abner/log引入三方库，就可以直接测试使用。

Test.ets

import { hilog } from '@kit.PerformanceAnalysisKit'
import { Log } from './Log';
import { logger } from './Logger';const DOMAIN = 0x0000;interface Obj {a: number;b: string;
}@Entry
@Component
struct Test {obj: Obj = {a: 1,b: '2'}build() {Column() {Button('点击打印').onClick(() => {console.log('123', JSON.stringify(this.obj))hilog.info(DOMAIN, 'testTag', '%{public}s', '12346');logger.info('123')logger.debug(JSON.stringify(this.obj))logger.warn('123', '123123')logger.error('12312', JSON.stringify(this.obj))Log.info('123')Log.debug(this.obj)Log.warn('123', '123123')Log.error(this.obj, '123123')})}.width('100%').height('100%').justifyContent(FlexAlign.Center)}
}

Logger.ets

/*** 1. 封装一个Logger工具类* 2. 工具类提供一系列的方法(info, debug, error, warn)* 3. 导出一个实例对象, 使用处通过实例对象调用方法*/
import { hilog } from "@kit.PerformanceAnalysisKit";const PREFIX = 'utils_logger'class Logger {private domain: number;private prefix: string;private format: string = "%{public}s, %{public}s";constructor(domain: number, prefix: string) {this.domain = domainthis.prefix = prefix}debug(...args: string[]): void {hilog.debug(this.domain, this.prefix, this.format, args);}info(...args: string[]): void {hilog.info(this.domain, this.prefix, this.format, args);}warn(...args: string[]): void {hilog.warn(this.domain, this.prefix, this.format, args);}error(...args: string[]): void {hilog.error(this.domain, this.prefix, this.format, args);}
}export const logger = new Logger(0x1234, PREFIX)

Log.ets

import { Log } from '@abner/log'// 初始化
Log.init({tag: "log_find_easy",domain: 0x0101,close: false,isHilog: true,showLogLocation: true,logSize: 1024
})export { Log }