移动推送
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 移动推送 > SDK 文档 > Android 接入指南 > 厂商通道接入指南 > FCM 通道接入

FCM 通道接入

最近更新时间：2023-06-01 16:56:57

我的收藏

本页目录：

操作场景

FCM 通道是谷歌推出的系统级推送通道，在国外具备谷歌 Service 框架的手机上，鉴于其较宽松的后台进程管理方式，在应用进程未被强制停止的情况下，可以收到推送消息。FCM 通道不支持国内集群。

操作步骤

获取密钥

FCM 推送支持两种密钥配置，以下方式二选一，推荐使用“服务器私钥”的新协议方式。
1. 服务器私钥 （推荐） 进入 FireBase 官网，注册应用信息。在 Firebase 项目 > 选择具体的项目应用 > 设置 > 服务账号 > Firebase Admin SDK，单击生成新的私钥，获取到 Firebase 服务器私钥 json 文件。然后进入 移动推送控制台 > 配置管理 > 基础配置 > FCM 官方推送通道 栏目中，选中“（推荐）服务器私钥”，单击点击上传，上传获取到的 json 文件。


2. 旧版服务器密钥 进入 FireBase 官网，注册应用信息。在Firebase 项目 > 选择具体的项目应用 > 设置 > 云消息传递 获取到的 FCM 应用推送 服务器密钥，并配置到 移动推送控制台 > 配置管理 > 基础配置 > FCM 官方推送通道 栏目中。



配置内容

1. 配置 google-services.json 文件。如图所示：


2. 配置 gradle，集成谷歌 service。
2.1 在项目级的 build.gradle 文件中的 dependencies 节点中添加下面代码：
classpath 'com.google.gms:google-services:4.2.0'
注意
如果使用低于4.2.0版本出现 FCM Register error! java.lang.IllegalStateException: Default FirebaseApp is not initialized in this process com.qq.xg4all. Make sure to call FirebaseApp.initializeApp(Context) first.，建议在 res/values 文件夹下的 string.xml， 加上 YOUR_GOOGLE_APP_ID。
2.2 在应用级的 build.gradle 文件中，添加依赖：
    implementation 'com.tencent.tpns:fcm:[VERSION]-release' // FCM 推送 [VERSION] 为当前 SDK 版本号，版本号可在 Android SDK 发布动态查看
     implementation  'com.google.firebase:firebase-messaging:17.6.0'
     //在应用级的 gradle 文件的最后一行代码中新增并将 google-services.json 放进您应用 model 的根路径下
apply plugin: 'com.google.gms.google-services'
注意：
FCM 推送 [VERSION] 为当前 SDK 版本号，版本号可在 Android SDK 发布动态 查看。
Google 配置 google-play-services（建议版本 17.0.0+，较低版本有可能出现无法注册 FCM 风险）。

启用 FCM 推送

在调用移动推送注册代码 XGPushManager.registerPush 前，添加以下代码设置：
XGPushConfig.enableOtherPush(this, true);
注册 FCM 成功的日志如下：
V/TPush: [XGPushConfig] isUsedOtherPush:true
I/TPush: [OtherPush] checkDevice pushClassNamecom.tencent.android.tpush.otherpush.fcm.impl.OtherPushImpl
I/TPush: [XGPushManager] other push token is : dSJA5n4fSZ27YeDf2rFg1A:APA91bGiqSPCMZTuyup**********f1fBIahZKYkth2OoDpixDPQmEZkQ11fX06mw_1kEaW5-jFmT4YwlER4qfX66h_BIoUxOyj_tKqZSUg7oHigIKaOrDWmMQfMAqGoT8qSfg  other push type: fcm

代码混淆

-keep class com.google.firebase.** {*;}
说明
混淆规则需要放在 App 项目级别的 proguard-rules.pro 文件中。

常见问题排查

推送 FCM 推送收不到，是什么原因？

1. 在境外具备谷歌 Service 框架的手机上，鉴于其较宽松的后台进程管理方式，在应用进程未被强制停止的情况下， FCM 消息抵达较为稳定。
2. 在大陆发行的国内品牌手机，其后台进程管理普遍较为严格，谷歌 service 后台服务同样也会受到限制，这些手机上 FCM 消息抵达可能会受到影响，FCM 无法进行下发和接收，建议保持 App 在前台接收。

什么是强制停止应用进程？

在手机设置-应用管理-具体应用-点击“结束运行”/“强制停止”等按钮停止了应用。大部分国内品牌手机，在多任务页面划掉应用进程，也可认为是强制停止了应用进程（境外手机不会）。
中国站