HBuilderX 2.7.10+ 版本以上支持FCM

# 概述

在海外网络环境下,部分网络在连接uni-push技术支持供应商个推的推送服务时,可能出现不稳定的情况。此时,开发者可以接入 FCM 辅助通道,当在个推服务断线的情况下,通过谷歌的 FCM 推送通道下发消息,提升推送到达率。

使用FCM时手机端需安装Google移动服务(GMS),并且可以正常连接Google服务(国内网络需要翻墙)

使用FCM必须先开通使用uni-push

# 从谷歌后台申请key信息

进入 Firebase官网创建项目,获取google-services.json文件及Server key

登录google账号,如果没有账号请先注册

登录后点击右上角的“Go to console”

打开项目列表页面,点击“Add project”创建项目

输入项目名称(根据自己应用取名),点击“Continue”

确认是否需要使用Google Analytics服务(根据自己需要开启或关闭),点击“Continue”

确认后创建项目,点击“Continue”

进入项目详情页面,点击“Android”图标添加Android应用

输入Android应用信息(包名、昵称、证书SHA-1),点击“Register App”

注册Android应用后下载配置文件“google-services.json”,保存google-services.json文件后面需要使用 点击“Next”继续

此步骤中的操作云端打包机已经处理,忽略提示信息,继续点击“Next”,进入下一步 完成注册Android应用,点击“Continue to console”回到项目详情页面

点击“Project settings”,进入项目设置页面

切换到“Cloud Messaging”项,获取“Server key”,保存Server key后面需要使用

由于新版Firebase Cloud Messaging API (V1)不提供Server key, 所以需要手动开启旧版 Cloud Messaging API

跳转到Api管理页面启动Cloud Messaging API

启动Cloud Messaging API后即可得到Server key

# uni-push后台配置FCM参数

参考文档 配置厂商推送参数 完成FCM参数配置。

配置保存成功后在HBuilderX中重新提交云端打包,并在“App-云打包”界面选择google play渠道:

如果你已经完成了uni-push的代码开发,只需完成上述配置和打包即可,不用修改代码。

# 本地离线打包

Android平台离线sdk集成uni-push支持FCM可参考:Push(消息推送)

# 注意事项

FCM 离线消息仅支持GOOGLE 推送,暂不支持国内设备商的海外发行版本