通常我们在开发应用程序时,需要在某些关键代码处输出日志信息,便于定位和排查问题。在运行应用后,通过查看日志信息来分析应用执行情况(如应用是否正常运行、代码运行时序、运行逻辑分支是否正常等)。
鸿蒙系统提供两个API供开发者调用并输出日志信息,即HiLog与console。两个API在使用时略有区分。
HiLog
打印日志接口说明
在输出日志前,需先调用isLoggable确认domain、tag和日志级别是否被禁止打印日志。示例如下:
hilog.isLoggable(0x0000, "testTag", hilog.LogLevel.INFO);
- 参数domain:用于指定输出日志所对应的业务领域,取值范围为0x0000~0xFFFF,开发者可以根据需要进行自定义。
- 参数tag:用于指定日志标识,可以为任意字符串,建议标识调用所在的类或者业务行为。
- 参数level:用于指定日志级别。
HiLog中定义了DEBUG、INFO、WARN、ERROR、FATAL五种日志级别,并提供了对应的方法输出不同级别的日志,接口如下表所示:
接口名 |
功能描述 |
debug(domain: number, tag: string, format: string, ...args: Array<Object>) |
输出DEBUG级别日志。仅用于应用/服务调试。 在DevEco Studio的terminal窗口或cmd里,通过命令“hdc shell hilogcat”设置可打印日志的等级为DEBUG。 |
info(domain: number, tag: string, format: string, ...args: Array<Object>) |
输出INFO级别日志。表示普通的信息。 |
warn(domain: number, tag: string, format: string, ...args: Array<Object>) |
输出WARN级别日志。表示存在警告。 |
error(domain: number, tag: string, format: string, ...args: Array<Object>) |
输出ERROR级别日志。表示存在错误。 |
fatal(domain: number, tag: string, format: string, ...args: Array<Object>) |
输出FATAL级别日志。表示出现致命错误、不可恢复错误。 |
- 参数domain和tag应与isLoggable中使用一致。
- 参数format:格式字符串,用于日志的格式化输出。格式字符串中可以设置多个参数,例如格式字符串为“%s World”,“%s”为参数类型为string的变参标识,具体取值在args中定义。
- format中的每个参数需添加隐私标识,分为{public}或{private},默认为{private}。{public}表示