企业官网建设流程全解析

前言

在生产环境中，App 的启动崩溃、页面跳转失败等问题，往往只能靠日志排查。HarmonyOS 提供了hilog日志系统，支持分级、过滤、脱敏。本篇以小分享 App 的EntryAbility为例，演示如何用hilog建立规范的日志埋点体系。详细 API 可参考 HarmonyOS hilog 官方文档。

一、hilog 的导入与初始化

1.1 导入语句

小分享 App 的EntryAbility.ets开头如下：

import { hilog } from '@kit.PerformanceAnalysisKit'; const DOMAIN = 0x0000;

1.2 关键点说明

关键点说明如下：

1. hilog位于@kit.PerformanceAnalysisKit套件中，按需导入即可
2. DOMAIN是日志域标识，通常用 16 进制整数，取值范围0x0000 ~ 0xFFFF
3. 一个 App 内不同模块可以定义不同的DOMAIN，便于过滤

二、hilog 的五个 API

2.1 API 列表

HarmonyOS 提供了五个hilogAPI，分别对应不同的日志级别：

2.2 小分享 App 的使用

小分享 App 主要使用info和error：

hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate'); hilog.error(DOMAIN, 'testTag', 'Failed to set colorMode. Cause: %{public}s', JSON.stringify(err));

三、format 字符串与脱敏

3.1 隐私修饰符

hilog的format参数遵循 C 风格占位符，但增加了隐私修饰符：

3.2 正确示例

正确示例代码如下：

hilog.info(DOMAIN, 'LoginTag', 'userId: %{private}s, loginCount: %{public}d', userId, count);

输出形如：userId: *** , loginCount: 5

3.3 错误示例

错误示例代码如下：

hilog.info(DOMAIN, 'LoginTag', 'userId: ' + userId); // ❌ 字符串拼接绕过脱敏

提示：字符串拼接会绕过脱敏机制，造成敏感信息泄漏，必须使用占位符格式化。

四、为生命周期埋点

4.1 完整埋点代码

小分享 App 在每个生命周期回调中都打了日志，便于还原执行时序：

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { try { this.context.getApplicationContext().setColorMode( ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET ); } catch (err) { hilog.error(DOMAIN, 'testTag', 'Failed to set colorMode: %{public}s', JSON.stringify(err)); } hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate'); } onWindowStageCreate(windowStage: window.WindowStage): void { hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageCreate'); windowStage.loadContent('pages/Index', (err) => { if (err.code) { hilog.error(DOMAIN, 'testTag', 'Failed to load: %{public}s', JSON.stringify(err)); return; } hilog.info(DOMAIN, 'testTag', '%{public}s', 'Succeeded in loading the content.'); }); } onForeground(): void { hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground'); } onBackground(): void { hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground'); }

4.2 埋点策略

小分享 App 的埋点策略如下：

1. 每个 Ability 生命周期回调都打info级日志
2. 异常分支打error级日志
3. 启动耗时通过info时间戳推算
4. 关键业务节点（如分享成功）打info日志

五、查看日志

5.1 方式 1：DevEco Studio HiLog 面板

DevEco Studio 底部的HiLog面板支持按 tag、domain、级别过滤。这是开发阶段最常用的查看方式。

5.2 方式 2：hdc 命令行

通过hdc命令行可以查看设备日志：

hdc shell hilog -T testTag -L I

参数说明如下：

• -T：按 tag 过滤
• -L：按级别过滤（D/I/W/E/F）
• -D：按 domain 过滤

5.3 方式 3：保存到文件

通过以下命令可以将日志保存到设备文件：

hdc shell hilog -r && hdc shell hilog -w start -t 30

六、hilog 最佳实践

6.1 统一 tag 命名

建议采用统一的 tag 命名规范：

AbilityTag - Ability 生命周期 RouterTag - 路由跳转 NetworkTag - 网络请求 DbTag - 数据库操作 UiTag - UI 渲染

6.2 避免高频日志

在ForEach循环中打info日志会迅速填满缓冲区，建议改为debug或采样输出。

6.3 务必捕获错误码

异步回调中的err.code是排查问题的关键，必须打印：

windowStage.loadContent('pages/Index', (err) => { if (err.code) { hilog.error(DOMAIN, 'testTag', 'err.code: %{public}d, err.msg: %{public}s', err.code, JSON.stringify(err)); return; } });

6.4 发布版本关闭 debug

通过hilog.setLogLevel设置全局最低级别，避免性能损耗：

hilog.setLogLevel(DOMAIN, hilog.LogLevel.WARN);

七、本篇核心知识点

7.1 hilog 核心 API

hilog 核心 API 总结如下：

1. hilog.debug/info/warn/error/fatal五个级别
2. DOMAIN标识模块，便于过滤
3. tag标识调用方，便于定位
4. format用%{public}s/%{private}s控制脱敏

7.2 实战开发要点

实战开发中需要重点关注以下几个要点：

• 日志要在关键节点埋点，便于还原执行时序
• 敏感信息必须使用%{private}s脱敏
• 发布版本应关闭debug级日志
• 异步回调的错误码必须打印

总结

本文详细讲解了 HarmonyOS hilog 日志系统的使用方法，结合小分享 App 的EntryAbility生命周期埋点，演示了日志分级、脱敏、查看的完整流程。下一篇我们将深入module.json5这个模块级配置文件，解析入口 Ability 声明的每个字段。

附录：完整实现细节

1. 核心 API 参考

2. 完整代码示例

// 核心功能代码 // 详见正文中的完整实现

3. 常见问题排查

4. 最佳实践

1. 错误处理完善，使用 try/catch 包裹
2. 资源及时释放，避免内存泄漏
3. 异步操作使用 async/await
4. 权限配置完整，按需申请

5. 完整代码文件索引

6. 实现要点总结

核心实现要点：

1. API 的正确使用方法和参数说明
2. 完整的代码实现流程
3. 常见问题的排查方案
4. 性能优化和安全建议

7. 总结

本文详细讲解了小分享 App 中对应功能的完整实现。通过本文的学习，读者可以掌握 HarmonyOS 开发的核心 API 使用方法和最佳实践。

开发注意事项

1. API 版本兼容性

确保使用的 API 在目标 SDK 版本中可用。不同版本的 HarmonyOS 可能对 API 的支持有所不同，建议查阅官方文档确认。

2. 权限配置

根据功能需求配置相应的系统权限。权限在 module.json5 中声明，运行时通过 abilityAccessCtrl 申请。

3. 错误处理

所有异步操作使用 try/catch 包裹，确保异常不会导致应用崩溃。错误信息通过 hilog 输出，便于调试。

4. 资源释放

使用完毕后及时释放系统资源，避免内存泄漏。例如：文件操作后关闭文件句柄，数据库操作后关闭 ResultSet。

5. 性能优化

避免在主线程执行耗时操作，使用异步 API 处理耗时任务。大量数据渲染时使用 LazyForEach 懒加载。

完整代码文件索引

核心 API 参考

总结

本文详细讲解了小分享 App 中对应功能的完整实现，涵盖 API 使用、代码示例、常见问题、性能优化等核心知识点。通过本文的学习，读者可以掌握 HarmonyOS 开发的完整流程。

如果这篇文章对你有帮助，欢迎点赞👍、收藏⭐、关注🔔，你的支持是我持续创作的动力！