HarmonyOS Notification Kit 本地通知发布实战指南

大家好啊～我是那个在代码海洋里扑腾了10+年的老水手，目前主业是"鸿蒙应用开发+Web全栈开发"双面间谍。
这些年写过的BUG能绕地球半圈，填过的坑能养活一个施工队，当然也攒了点有用的经验（毕竟吃一堑长一智嘛）。
平时最大的爱好就是把复杂的技术掰碎了、嚼烂了，做成普通人也能看懂的小甜点分享给大家。
如果你也喜欢折腾代码、踩坑、填坑，或者想找个人唠唠技术嗑，欢迎关注我一起交流～毕竟，独乐乐不如众乐乐，一起进步才是正经事！

一、别再做通知界的"小透明"了

做鸿蒙开发的同学应该都遇到过这种场景：

• 做了个倒计时功能，结果应用退到后台就没动静了
• 写了个下载管理器，用户切到别的应用就看不到进度了
• 开发了个IM应用，新消息来了只有个简单的提示，体验跟原生应用差一截

其实这些问题，用 HarmonyOS 的 Notification Kit 就能轻松解决。但我发现很多开发者要么不知道这个宝藏工具，要么用起来不得要领，最后做出来的通知要么不好看，要么功能不全。

今天咱们就好好聊聊 Notification Kit，从授权到发布再到优化，把本地通知这事儿彻底聊透。

二、Notification Kit 到底是个啥？

简单说，Notification Kit 就是鸿蒙系统给开发者提供的本地通知发布框架。当你的应用在前台运行时，它能帮你把通知直接推送给用户；当应用退到后台，只要进程还在，通知一样能发。

核心定位：当应用进程处于运行时，使用 Notification Kit 发布本地通知。当应用进程终止后，本地通道关闭，如需进行离线通知推送，应接入 Push Kit。

三、这玩意儿能干嘛？

Notification Kit 提供的能力可不止发个简单的文本通知，它能做的事儿多了：

• 发布通知：支持文本、多行文本、进度条等多种类型
• 管理通知角标：在应用图标右上角显示未读通知数量
• 管理通知渠道：创建不同类别的通知渠道，每种渠道有独立的提醒方式
• 更新通知：对已发布的通知进行内容更新，比如下载进度
• 取消通知：用户可以取消单条、部分或全部已发布的通知
• 请求通知授权：引导用户开启通知权限
• 跨设备协同：以手机为中心，实现与手表、平板等设备的通知协同与去重
• 应用内设置快捷入口：在系统通知设置页面提供快速跳转到应用内通知管理页面的入口

四、哪些场景能用？

其实本地通知的使用场景比你想象的要广：

• 进度同步：文件上传/下载进度实时更新
• 即时提醒：客服消息、支付结果、交易状态变更
• 信息更新：运动步数刷新、新闻资讯推送、IM聊天新消息
• 后台任务提醒：结合 Background Tasks Kit，实现应用退到后台后的定时提醒（比如购物抢购）

五、本地通知发布全流程

发通知这事儿说简单也简单，说复杂也复杂，关键是要走对流程。我画了个流程图，把从授权到用户收到通知的全过程都标清楚了：

流程步骤详解：

1. 请求通知授权：在应用发布第一条通知前，必须调用 requestEnableNotification() 接口请求用户授权。用户首次会看到授权弹窗。

   这里有个坑要注意：如果用户拒绝了授权，后续你再调用这个接口不会再弹窗，只能引导用户通过 openNotificationSettings() 打开系统设置页面手动开启。

2. 发布通知到通知服务：应用构建 NotificationRequest 对象，包含通知ID、内容、渠道类型等信息，然后调用 publish() 方法发布。

3. 通知服务展示通知：系统通知服务接收请求，根据设备能力和用户设置，把通知展示在通知中心、横幅、锁屏等位置。

六、通知样式大盘点

Notification Kit 支持多种基础通知样式，实际显示效果会根据具体设备有所不同：

类型	样式描述	规格说明
文本	基础文本通知，包含标题、文本内容、附加信息	文本内容最多显示三行，超长后以"…"截断
多行文本	扩展文本通知，继承文本通知字段，增加多行文本内容(lines)、内容概要(briefText)和展开标题(longTitle)	-
通知角标	应用图标角标，在应用图标右上角以数字形式展示未读通知数量	超过99显示"99+"。小于等于0则清除角标
进度条	进度条通知，用于展示进度，如文件下载	需要配合特定的通知模板（如downloadTemplate）使用

七、这些限制要注意

用 Notification Kit 发通知不是想怎么发就怎么发，有几个限制你必须知道：

• 数量限制：单个应用在通知中心留存的通知数量上限为 24条。

• 大小限制：单条通知的长度不能超过 200KB (跨进程序列化大小)。

• 频次限制：

  • 单个应用发布新通知：≤ 10条/秒
  • 单个应用更新通知：≤ 20条/秒
  • 所有三方应用发布新通知：≤ 15条/秒
  • 所有三方应用更新通知：≤ 30条/秒
    超过限制会导致发布或更新失败，并返回相应错误码。

• 跨设备去重：用于去重的 appMessageId 字段需保证唯一性，且仅在通知发布后的 24小时内有效。

八、别踩违规红线

应用发送的通知内容必须遵守 Push Kit 的通知内容原则。如果出现违规行为（比如垃圾广告、欺诈信息等），会根据《违规分类、违规行为及违规处罚标准》进行处理，可能面临通知能力被限制或封禁等处罚。

九、与其他 Kit 的协作

Notification Kit 不是孤立存在的，它和鸿蒙其他 Kit 配合使用能发挥更大的作用：

• Push Kit：当应用进程终止后，使用 Push Kit 从云端推送离线通知到设备。

• Background Tasks Kit：实现应用退到后台或进程终止后的定时提醒类通知（如日历提醒、闹钟）。

• Ability Kit：通过 getWantAgent() 设置用户点击通知或通知按钮后的行为意图，例如拉起指定应用页面或发布公共事件。

• 跨设备协同：与系统分布式能力结合，实现手机、手表、平板间的通知同步与智能去重。

十、实战建议

根据我这些年的实战经验，给大家几个使用 Notification Kit 的建议：

1. 合理规划通知渠道：根据通知类型创建不同的渠道，比如社交通信、服务提醒、内容资讯等，让用户可以按需开启或关闭。

2. 优化通知内容：通知标题要简洁明了，内容要直击要点，避免冗长的描述。

3. 善用通知更新：对于需要实时更新的场景（如下载进度），使用通知更新而不是重复发布新通知。

4. 处理权限问题：在应用首次启动时就引导用户开启通知权限，并在权限被拒绝时提供清晰的引导。

5. 测试不同设备：不同设备的通知显示效果可能不同，要在多种设备上测试确保体验一致。

6. 遵守限制规则：严格遵守通知数量、大小和频次限制，避免被系统限流。

十一、写在最后

HarmonyOS Notification Kit 是一个功能强大、集成度高的本地通知解决方案。它不仅提供了从授权、发布、展示到管理的全链路能力，还通过跨设备协同、与后台任务结合、设置快捷入口等设计，极大地提升了用户体验和开发效率。

其实本地通知这事儿，说难不难，说简单也不简单。关键是要理解它的工作原理，掌握正确的使用方法，避开那些容易踩的坑。希望这篇文章能给你一些启发，让你在开发鸿蒙应用时，能把通知功能做得更加专业、更加贴心。

如果你在使用 Notification Kit 的过程中遇到了什么问题，或者有什么好的经验想分享，欢迎在评论区留言交流。咱们一起学习，一起进步！