当前位置：首页 > news >正文

HarmonyOS-消息推送

news 2025/7/19 13:11:28

一. 服务简述

Push Kit（推送服务）是华为提供的消息推送平台，建立了从云端到终端的消息推送通道。所有HarmonyOS 应用可通过集成 Push Kit，实现向应用实时推送消息，使消息易见，构筑良好的用户关系，提升用户的感知度和活跃度。

二. 开发准备

1）在华为开发者联盟网站，注册成为开发者，并完成实名认证。

2）参考调试应用与发布应用，添加 APP ID、创建证书、添加调试设备、创建 Profile 文件。

3）在 AppGallery Connect 上，参考创建项目与创建应用中完成 HarmonyOS 应用的创建。

4）参考配置应用签名证书指纹，添加公钥指纹。

三. 工程配置

1）在应用 entry 模块的 module.json5 中添加 metadata - client_id（client_id 在 AppGallery Connect - 我的项目中查看）。

{"module": {"name": "entry",..."metadata": [{"name": "client_id","value": "11659886"}]}
}

2）在应用 entry 模块的 module.json5 中添加 abilities - skills - actions。

{"module": {"name": "entry",..."abilities": [{"name": "EntryAbility",..."skills": [{"actions": ["action.system.home","ohos.want.action.viewData"]}, {"actions": ["action.ohos.push.listener", // 订阅场景消息（'IM' | 'VoIP' | 'BACKGROUND' | 'EMERGENCY'）"com.base.action.pushService" // 与服务端共同协议的action]}]}]}
}

四. 功能实现

1. 获取pushToken

import { pushService } from '@kit.PushKit';export class PushManager {public getPushToken(): Promise<string> {return pushService.getToken()}
}

2. 通知权限申请

import notificationManager from '@ohos.notificationManager';export class PushManager {public async checkNotificationPermissions(): Promise<void> {let grantStatus = await notificationManager.isNotificationEnabled()if (!grantStatus) {await notificationManager.requestEnableNotification()grantStatus = await notificationManager.isNotificationEnabled()if (!grantStatus) {console.log('通知权限未开启')} else {console.log('通知权限已开启')}} else {console.log('通知权限已开启')}}
}

3. 消息接收/处理

1）冷启动

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {super.onCreate(want, launchParam)if (want && want.action === 'com.base.action.pushService') {console.log(`push_want_parameters: ${JSON.stringify(want.parameters)}`)PushManager.getInstance().onCreate(want)}
}

2）后台唤起

onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {super.onNewWant(want, launchParam)if (want && want.action === 'com.base.action.pushService') {console.log(`push_want_parameters: ${JSON.stringify(want.parameters)}`)PushManager.getInstance().onNewWant(want)}
}

4. 订阅场景消息

场景化消息类型包含IM（通知扩展消息场景）、VoIP（应用内通话消息场景）、BACKGROUND（后台消息场景）、EMERGENCY（紧急事件消息场景）。

import { pushService, pushCommon } from '@kit.PushKit';export class PushManager {public receiveMessage(pushType: 'IM' | 'VoIP' | 'BACKGROUND' | 'EMERGENCY'): void {const ability = AppStorage.get('ability') as UIAbility // 在EntryAbility中存储AbilitypushService.receiveMessage(pushType, ability, (payload: pushCommon.PushPayload) => {const data: PushPayloadData = JSON.parse(payload.data) as PushPayloadDataconsole.log(`pushService_receiveMessage_data : ${JSON.stringify(data)}`);})}
}