鸿蒙5.0版开发：使用HiLog打印日记（ArkTS）

在应用开发过程中，可在关键代码处输出日记信息。在运行应用后，通过查看日记信息来分析应用执行情况（如应用是否正常运行、代码运行时序、运行逻辑分支是否正常等）。

系统提供差别的API供开发者调用并输出日记信息，即HiLog与console。两个API在使用时略有差别，本文重点介绍HiLog的用法。
接口阐明

HiLog中定义了DEBUG、INFO、WARN、ERROR、FATAL五种日记级别，并提供了对应的方法输出差别级别的日记，接口如下表所示。
接口名功能形貌isLoggable(domain: number, tag: string, level: LogLevel)在打印日记前调用该接口，查抄指定领域标识、日记标识和级别的日记是否可以打印。debug(domain: number, tag: string, format: string, ...args: any[]) 输出DEBUG级别日记。仅用于应用/服务调试。
在DevEco Studio的terminal窗口或cmd里，通过命令“hdc shell hilogcat”设置可打印日记的等级为DEBUG。
info(domain: number, tag: string, format: string, ...args: any[])输出INFO级别日记。表示平凡的信息。warn(domain: number, tag: string, format: string, ...args: any[])输出WARN级别日记。表示存在警告。error(domain: number, tag: string, format: string, ...args: any[])输出ERROR级别日记。表示存在错误。fatal(domain: number, tag: string, format: string, ...args: any[])输出FATAL级别日记。表示出现致命错误、不可恢复错误。 参数剖析

阐明
   

• isLoggable()和具体日记打印接口使用的domain和tag应保持一致。
  
• isLoggable()使用的level，应和具体日记打印接口级别保持一致。
  

  

• domain：用于指定输出日记所对应的业务领域，取值范围为0x0000~0xFFFF，开发者可以根据需要进行自定义。
  
• tag：用于指定日记标识，可以为恣意字符串，发起标识调用所在的类或者业务行为。
  
• level：用于指定日记级别。
  
• format：格式字符串，用于日记的格式化输出。日记打印的格式化参数需按照“%{private flag}specifier”的格式打印。
     隐私标识符（private flag）阐明private表示日记打印结果不可见，输出结果为<private>。public表示日记打印结果可见，明文显示参数。无缺省值默认为private，日记打印结果不可见。   格式阐明符（specifier）阐明示例d/i支持打印number和bigint范例。123s支持打印string、undefined、boolean和null范例。"123"格式字符串中可以设置多个参数，例如格式字符串为“%s World”，“%s”为参数范例为string的变参标识，具体取值在args中定义。
  
• args：可以为0个或多个参数，是格式字符串中参数范例对应的参数列表。参数的数目、范例必须与格式字符串中的标识一一对应。
  

约束与限制

日记打印最多打印4096字节，超出限制文本将被截断。
开发示例

在按钮中增加一个单击变乱，单击按钮时打印一条日记。

• 新建一个工程，选择“Empty Ability”。
  
• 工程设置界面中，Model选择“Stage”。
  
• 在Project窗口单击entry > src > main > ets > pages，打开工程中的Index.ets文件，添加一个按钮，单击按钮打印日记。
  示例代码如下：
  
  1. // Index.ets
  3. import { hilog } from '@kit.PerformanceAnalysisKit';
  5. @Entry
  6. @Component
  7. struct Index {
  8.   build() {
  9.     Row() {
  10.       Column() {
  11.         // 添加按钮，以响应用户点击
  12.         Button() {
  13.           Text('Next')
  14.             .fontSize(30)
  15.             .fontWeight(FontWeight.Bold)
  16.         }
  17.         .type(ButtonType.Capsule)
  18.         .margin({
  19.           top: 20
  20.         })
  21.         .backgroundColor('#0D9FFB')
  22.         .width('40%')
  23.         .height('5%')
  24.         // 跳转按钮绑定onClick事件，点击时打印日志
  25.         .onClick(() => {
  26.           hilog.isLoggable(0xFF00, "testTag", hilog.LogLevel.INFO);   
  27.           hilog.info(0xFF00, "testTag", "%{public}s World %{public}d", "hello", 3);
  28.         })
  29.       }
  30.       .width('100%')
  31.     }
  32.     .height('100%')
  33.   }
  34. }

  复制代码
  以输出一条INFO级别的信息为例，表示输出一条平凡信息，格式字符串为：
  
  1. ”%{public}s World %{public}d”

  复制代码
  此中变参"%{public}s"为公共的字符串，%{public}d为公共的整型数。
  
• 在真机上运行该工程，单击应用/服务界面上的“Next”按钮。
  
• 在DevEco Studio的底部，切换到“Log”窗口，设置日记的过滤条件。
  选择当前的设备及历程，日记级别选择Verbose，搜索内容设置为“testTag”。此时窗口仅显示符合条件的日记。
  打印日记结果为“hello World 3”。
  
  
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。