输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
指南
指南应用服务Notification Kit（用户通知服务）更新通知

更新通知

更新时间: 2026-08-03 11:34
本文导读

从API version 18开始，支持应用只更新已发布的通知。主要用于上传下载进度更新、IM会话消息更新等场景。

接口说明

通知发布更新接口说明详见下表，通知更新可通过入参NotificationRequest携带updateOnly字段来指定，不指定该字段默认为false。

  • 当updateOnly为true时，若相同ID通知存在，则更新通知；若相同ID通知不存在，则更新失败，并且不创建新的通知。

  • 当updateOnly为false时，若相同ID通知存在，则更新通知；若相同ID通知不存在，则创建通知。

展开
接口名 描述
publish(request: NotificationRequest, callback: AsyncCallback<void>): void 发布更新通知。

开发步骤

下面以进度条通知发布更新为例。

  1. 导入模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { notificationManager } from '@kit.NotificationKit';
    2. import { BusinessError } from '@kit.BasicServicesKit';
    3. import { hilog } from '@kit.PerformanceAnalysisKit';
    4. 

    5. const TAG: string = '[PublishOperation]';
    6. const DOMAIN_NUMBER: number = 0xFF00;
    UpdateNotification.ets

  2. 发布进度条通知。

    收起
    自动换行
    深色代码主题
    复制
    1. let notificationRequest: notificationManager.NotificationRequest = {
    2.   id: 5,
    3.   content: {
    4.     notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
    5.     normal: {
    6.       title: 'test_title',
    7.       text: 'test_text',
    8.       additionalText: 'test_additionalText'
    9.     }
    10.   },
    11.   // 构造进度条模板，name字段当前需要固定配置为downloadTemplate
    12.   template: {
    13.     name: 'downloadTemplate',
    14.     data: { title: 'File Title', fileName: 'music.mp4', progressValue: 50 }
    15.   }
    16. };
    17. 

    18. // 发布通知
    19. notificationManager.publish(notificationRequest, (err: BusinessError) => {
    20.   if (err) {
    21.     hilog.error(DOMAIN_NUMBER, TAG,
    22.       `Failed to publish notification. Code is ${err.code}, message is ${err.message}`);
    23.     return;
    24.   }
    25.   hilog.info(DOMAIN_NUMBER, TAG, 'Succeeded in publishing notification.');
    26. });
    UpdateNotification.ets

  3. 通过NotificationRequest接口携带updateOnly字段更新进度条通知。

    收起
    自动换行
    深色代码主题
    复制
    1. let notificationRequest: notificationManager.NotificationRequest = {
    2.   id: 5,
    3.   updateOnly: true,
    4.   content: {
    5.     notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
    6.     normal: {
    7.       title: 'test_title',
    8.       text: 'test_text',
    9.       additionalText: 'test_additionalText'
    10.     }
    11.   },
    12.   // 构造进度条模板，name字段当前需要固定配置为downloadTemplate
    13.   template: {
    14.     name: 'downloadTemplate',
    15.     data: { title: 'File Title', fileName: 'music.mp4', progressValue: 99 }
    16.   }
    17. };
    18. 

    19. // 更新发布通知
    20. notificationManager.publish(notificationRequest, (err: BusinessError) => {
    21.   if (err) {
    22.     hilog.error(DOMAIN_NUMBER, TAG,
    23.       `Failed to update notification. Code is ${err.code}, message is ${err.message}`);
    24.     return;
    25.   }
    26.   hilog.info(DOMAIN_NUMBER, TAG, 'Succeeded in updating notification.');
    27. });
    UpdateNotification.ets
为通知添加行为意图
取消通知
相关推荐
文档发布进度条类型通知
文档发布文本类型通知
文档notification.h
文档测试服务端通知
文档NotificationExtensionContent
文档@system.notification (通知消息)
文档NotificationInfo
文档NotificationRequest
文档NotificationExtensionSubscriptionInfo
视频课程给应用添加通知
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词