厂商通道参数申请指南

本文旨在指导用户获取厂商通道的推送参数，并完成极光控制台上的厂商参数配置。

鸿蒙参数获取

注册华为开发者账号

进入 华为开发者联盟，注册华为开发者账号，详情参考 注册账号。

创建项目

是否新建项目，开发者需根据实际业务情况，酌情选择。如果不需要新建项目，则直接查看后续步骤。

开通推送服务

选择【APP ID】-【HarmonyOS】，进入对应创建好的鸿蒙应用。

特别注意，鸿蒙应用创建完成后，您一定要记得配置应用「SHA256证书/公钥指纹」：点击“SHA256证书/公钥指纹”后的“添加公钥指纹（HarmonyOS API 9及以上）”，选择您集成 SDK 时「配置签署」对应的证书文件。

获取服务密钥

【凭证】-【项目级凭证】-【服务账号凭证】

点击“确认”后，会自动下载服务凭证的JSON 文件，请开发者妥善保存，并配置到极光后台。

获取应用级 Client ID

【应用管理】选择对应鸿蒙应用，【基本信息】获取复制该应用的 Client ID。

请使用应用级 Client ID，不要使用项目级 Client ID。字段位置和含义可参考华为官方文档查看应用信息。

极光平台鸿蒙配置

进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，选择【HarmonyOS】平台，填写包名、上传服务密钥 JSON 文件并填写应用级 Client ID，保存配置即可。

应用级 Client ID 用于鸿蒙厂商通道的消息撤回。未配置 Client ID 不影响普通推送，但鸿蒙厂商通道撤回不会生效。

极光平台启用鸿蒙通道

进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面，选择【HarmonyOS】平台，「启用」鸿蒙通道。

鸿蒙通道回执配置指南

完成鸿蒙厂商通道 SDK 集成后，需要开发者在华为开放平台开通并配置消息回执，方可把鸿蒙的送达统计等数据回调到极光平台，具体操作如下：

1.登录华为 AppGallery Connect网站。

2.点击“我的项目”，在项目列表中找到您的项目，通过增长-推送服务-配置导航到“配置”页签。

3.在该页面可以选择配置项目级回执或者应用级回执，需要注意的是项目级回执消息接收 URL 地址，对该项目下所有应用生效。如果您同时配置了项目级回执和应用级回执地址，则优先获取应用级回执地址信息。

4.这里以应用级回执举例，选择需要配置回执的应用，点击“开通”应用回执状态。

5.进入回执参数配置，新建回执。

6.点击“新建回执”后，需要配置如下参数。

• 回执名称：填写自定义名称。
• 回调地址： https://xpnscb.jpush.cn/v3/hmpnsreport
• 支持版本：请一定选择华为 V2 版本。

7.点击“测试回执”可以对回执地址进行功能测试，点击“提交”完成回执的创建。