鸿蒙应用推送通知：本地通知与远程推送实现
项目地址: https://gitcode.com/GitHub_Trending/ha/harmonyos-tutorial 你是否还在为鸿蒙应用无法及时触达用户而烦恼？是否想让你的应用在用户锁屏时也能传递重要信息？本文将带你从零开始掌握鸿蒙应用的通知推送技术，包括本地通知的创建与管理，以及远程推送的接入流程。读完本文后，你将能够实现消息实时推送、自定义通知样式、处理通知交互等核心功能，让应用体验提升一个档次。
鸿蒙通知系统概述
鸿蒙操作系统（HarmonyOS）提供了统一的通知管理机制，支持本地通知和远程推送两种模式。本地通知由应用在设备本地触发，适用于闹钟提醒、日程通知等场景；远程推送则通过华为推送服务（Push Kit）实现跨设备消息传递，确保用户即使离线也能收到重要信息。
通知系统主要涉及以下核心组件：
- NotificationSlot（通知槽）：管理通知的显示行为，包括声音、振动、优先级等
- NotificationRequest（通知请求）：定义通知的具体内容，如标题、文本、图标等
- NotificationHelper（通知助手）：提供发布、取消通知的核心API
项目中提供了完整的通知示例代码，可参考Notification示例和NotificationOnPhone示例了解实际实现。
本地通知实现步骤
创建通知槽
通知槽是鸿蒙系统中管理通知行为的重要机制，每个通知必须关联一个通知槽。以下是创建通知槽的关键代码：
// 创建notificationSlot对象
NotificationSlot slot = new NotificationSlot("slot_001", "slot_default", NotificationSlot.LEVEL_HIGH);
slot.setLevel(NotificationSlot.LEVEL_HIGH); // 设置提醒级别
slot.setDescription("NotificationSlotDescription"); // 设置提示内容
slot.setEnableVibration(true); // 设置振动提醒
slot.setLockscreenVisibleness(NotificationRequest.VISIBLENESS_TYPE_PUBLIC); // 设置锁屏模式
slot.setEnableLight(true); // 设置开启呼吸灯提醒
slot.setLedLightColor(Color.RED.getValue()); // 设置呼吸灯的提醒颜色
try {
NotificationHelper.addNotificationSlot(slot);
} catch (RemoteException ex) {
HiLog.warn(LABEL_LOG, "添加通知槽发生异常");
}
在这段代码中，我们创建了一个高优先级的通知槽，启用了振动和呼吸灯提醒，并设置了红色的呼吸灯颜色。通知槽的ID（"slot_001"）需要在应用内保持唯一，以便后续管理。
构建通知内容
通知内容通过NotificationNormalContent类定义，支持标题、文本等基本信息：
String title = "新消息提醒";
String text = "您有一条未读消息，请查收";
NotificationRequest.NotificationNormalContent content = new NotificationRequest.NotificationNormalContent();
content.setTitle(title).setText(text);
NotificationRequest.NotificationContent notificationContent = new NotificationRequest.NotificationContent(content);
对于更复杂的通知需求，鸿蒙还支持富媒体通知、进度条通知等高级样式，可根据实际场景选择合适的通知类型。
发布与取消通知
使用NotificationHelper类的publishNotification方法发布通知，每个通知需要一个唯一的ID以便后续管理：
notificationId++; // 递增的序列确保通知ID唯一
NotificationRequest request = new NotificationRequest(notificationId);
request.setContent(notificationContent); // 设置通知的内容
request.setSlotId(slot.getId()); // 关联之前创建的通知槽
try {
NotificationHelper.publishNotification(request);
HiLog.info(LABEL_LOG, "通知发布成功");
} catch (RemoteException ex) {
HiLog.warn(LABEL_LOG, "发布通知发生异常");
}
取消通知同样简单，只需调用cancelNotification方法并传入通知ID：
private void cancelNotification() {
try {
NotificationHelper.cancelNotification(notificationId);
HiLog.info(LABEL_LOG, "通知取消成功");
} catch (RemoteException ex) {
HiLog.warn(LABEL_LOG, "取消通知发生异常");
}
}
完整的本地通知实现代码可参考MainAbilitySlice.java文件，该示例还包含了UI交互部分，通过按钮触发通知的发布与取消。
远程推送接入流程
集成华为推送服务
远程推送需要集成华为推送服务（Push Kit），首先需要在华为开发者联盟注册应用并获取appid。然后在项目的config.json文件中添加推送服务配置：
"deviceConfig": {
"default": {
"push": {
"hwPushAppId": "你的appid",
"hwPushEnable": true
}
}
}
获取设备令牌
应用启动时，需要向华为推送服务器注册并获取设备令牌（Token），用于标识唯一设备：
// 请求Push Token
PushTokenCallback callback = new PushTokenCallback() {
@Override
public void onResult(String token) {
if (token != null) {
HiLog.info(LABEL_LOG, "获取Push Token成功: " + token);
// 将token发送到应用服务器
sendTokenToServer(token);
}
}
};
try {
PushManager.getToken(getAbility(), callback);
} catch (PushException e) {
HiLog.error(LABEL_LOG, "获取Push Token失败: " + e.getMessage());
}
接收透传消息
远程推送的消息通过PushReceiver接收，需要在config.json中注册接收器：
"abilities": [
{
"name": ".MyPushReceiver",
"type": "service",
"visible": true,
"permissions": ["com.huawei.pushagent.permission.RUNTIME_PERMISSION"]
}
]
然后实现消息接收逻辑：
public class MyPushReceiver extends PushReceiver {
private static final HiLogLabel LABEL = new HiLogLabel(HiLog.LOG_APP, 0x00201, "MyPushReceiver");
@Override
public void onPushMsg(Context context, byte[] msg, String token) {
String message = new String(msg, StandardCharsets.UTF_8);
HiLog.info(LABEL, "收到透传消息: " + message);
// 处理透传消息，可创建本地通知展示
showNotification(message);
}
}
通知交互与高级功能
通知点击事件处理
为通知添加点击事件，使用户点击通知时打开应用的特定页面：
Intent intent = new Intent();
Operation operation = new Intent.OperationBuilder()
.withDeviceId("")
.withBundleName(getBundleName())
.withAbilityName(".DetailAbility")
.withUri(Uri.parse("data://notification/" + notificationId))
.build();
intent.setOperation(operation);
NotificationRequest.NotificationContent content = new NotificationRequest.NotificationContent();
content.setIntent(intent); // 设置点击通知时的意图
自定义通知样式
鸿蒙支持丰富的通知样式定制，包括大文本样式、图片样式等：
// 创建大文本样式通知
NotificationBigTextContent bigTextContent = new NotificationBigTextContent();
bigTextContent.setTitle(title)
.setText(text)
.setBigText("这是一个大文本样式的通知，可以展示更多内容...");
NotificationRequest.NotificationContent content = new NotificationRequest.NotificationContent(bigTextContent);
通知渠道管理
Android O及以上版本引入了通知渠道（Notification Channel）概念，鸿蒙系统对此做了兼容，通过通知槽（NotificationSlot）实现类似功能。应用应根据通知类型创建不同的通知槽，如：
// 创建新闻类通知槽
NotificationSlot newsSlot = new NotificationSlot("slot_news", "新闻通知", NotificationSlot.LEVEL_DEFAULT);
// 创建营销类通知槽
NotificationSlot marketingSlot = new NotificationSlot("slot_marketing", "营销通知", NotificationSlot.LEVEL_LOW);
用户可以在系统设置中单独控制每个通知槽的行为，如是否允许声音、振动等。
实战案例与注意事项
完整代码示例
项目中提供了两个通知相关的示例：
- Notification：基础本地通知实现，包含通知的发布、取消和基本样式设置
- NotificationOnPhone：针对手机设备优化的通知示例，可能包含更多高级功能
常见问题解决
- 通知不显示：检查通知槽是否创建成功，通知级别是否设置正确，系统通知权限是否开启
- 重复通知：确保每次发布通知使用唯一的ID，或调用
cancelAllNotifications清除之前的通知 - 远程推送失败：检查网络连接，确认设备Token是否正确获取并发送到服务器，华为开发者联盟配置是否正确
性能优化建议
- 避免频繁发送通知，以免打扰用户
- 重要通知使用高优先级，一般通知使用低优先级
- 批量处理相似通知，如将多条聊天消息合并为一条通知
- 应用退到后台时仍需发送通知的场景，可使用后台服务
总结与展望
本文详细介绍了鸿蒙应用通知推送的两种实现方式：本地通知和远程推送。通过学习，你已经掌握了通知槽创建、通知内容构建、通知发布与取消等核心技能，以及华为推送服务的集成方法。
随着鸿蒙生态的不断发展，通知系统也将支持更多高级功能，如富媒体通知、交互式通知等。建议开发者持续关注官方文档更新，为用户提供更加丰富的通知体验。
最后，欢迎大家通过项目README.md提供的反馈渠道，分享你的使用经验或提出改进建议。如果你觉得本文对你有帮助，别忘了点赞、收藏和关注，后续将带来更多鸿蒙开发实用教程！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
