产品说明
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 配置页面。如下图所示:
通过开发者中心进入
-
使用 HBuilder 账号登录 开发者中心 ,登录后会进入“我的应用”列表
-
在左侧菜单点击“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使用指南 。