UniPush开通指南

产品说明

Uni Push 是 DCloud 推出的推送产品，适用于uni-app、5+app、wap2app云端打包后的App应用。下面介绍一下如何申请开通及使用。

申请开通 Uni Push

Uni Push 需要在 开发者中心 申请开通后，方可使用。在开通此业务之前需要先根据页面提示完成邮箱验证，已验证邮箱请忽略。

Tips: 目前只有应用所有者可以操作 Uni Push。应用协作者暂不支持。

在通过实名认证以后，有两个入口可以进入 Uni Push 配置页面：

• 通过 HBuilderX 进入
• 通过开发者中心进入

通过 HBuilderX 进入

打开 HBuilderX，双击项目中的 “manifest.json” 文件，选择“App 模块配置”，向下找到“Push(消息推送)”，勾选后，点击 “uniPush” 下面的配置链接，即可进入 Uni Push 配置页面。如下图所示：

通过开发者中心进入

1. 使用 HBuilder 账号登录 开发者中心 ，登录后会进入“我的应用”列表

2. 在左侧菜单点击“uniPush”，然后选择 1.0或2.0，进入Uni Push 信息页，左上角显示为当前要操作的应用，点击可以切换应用。如下图所示：
   

   

开通 UniPush

用户首次使用 UniPush 功能时，需要向个推同步身份信息。已通过实名认证的用户，会直接将实名认证信息同步给个推。如下图所示：

未提交实名认证信息的用户，需要在页面中输入相关信息后提交，如下图所示：

应用开通 Uni Push 功能时，需要提交应用相关信息，如下图所示：
注意：在申请开通时，需要确保输入的 Android包名或 iOS Bundle ID 必须与打包时配置的一致，否则可能会导致无法收到推送消息。

• Android平台：
  Android包名必须与HBuilderX中App云端打包时配置的Android包名一致；Android 应用签名必须填入打包时使用证书的SHA1指纹。
• iOS平台
  iOS BundleId必须与HBuilderX中App云端打包时配置的Bundle ID（AppID）一致。

如果已经开通 Uni Push，会看到如下页面：

iOS推送证书配置

iOS 平台还需要在 “配置管理”-“应用配置” 页面上传推送证书
如何获取推送证书请参考个推官方文档教程 iOS证书配置指南

云端打包

应用开通 Uni Push 功能以后，只需要在 HBuilderX 中打开manifest.json,选择“App SDK配置”，向下找到推送功能配置，勾选 “DCloud UniPush” 即可。

厂商推送参数设置（可选，应用离线时可提高推送成功率）

Uni Push 集成并统一了各个手机厂商的系统级推送，目前支持魅族、OPPO、华为、小米、VIVO。如果需要使用厂商推送，需要先在各厂商开发者平台申请。
申请通过后厂商会提供推送的相关参数，需要将这些参数配置到 DCloud 开发者中心后台。
厂商参数配置页面如下图所示：

修改应用信息

修改应用基本信息

在此页面可以修改应用名称、应用的 Android 包名和签名信息、iOS 包名。

关闭UniPush

当应用不再使用 UniPush 时，可在此页面关闭该功能。

重置 MasterSecret

MasterSecret 是 Uni Push 服务端API鉴权码，用于验证调用合法性。在调用服务端API时需要提供。如果 MasterSecret 泄漏，会对业务安全产生重大影响，可以在此处进行重置操作。重置 MasterSecret 会导致当前使用的 MasterSecret 失效，在进行重置操作前，请确认重置操作是否会对生产环境产生影响。如果确实需要进行重置，建议在业务低峰时段操作。

使用推送

推送使用方法，参考文档 UniPush使用指南 。