移动推送文档中心入门中心API 中心SDK 中心文档活动我的反馈文档反馈官招募中，报名立赚积分兑换代金券！> HOT文档中心>移动推送>SDK 文档>Android 接入指南>厂商通道接入指南>FCM 通道接入FCM 通道接入最近更新时间：2025-03-11 16:12:52
微信扫一扫QQ新浪微博复制链接链接复制成功我的收藏本页目录：操作场景操作步骤配置内容启用 FCM 推送代码混淆常见问题排查操作场景FCM 通道是谷歌推出的系统级推送通道，在国外具备谷歌 Service 框架的手机上，鉴于其较宽松的后台进程管理方式，在应用进程未被强制停止的情况下，可以收到推送消息。FCM 通道不支持国内集群。操作步骤进入 Firebase 官网，注册应用信息。在 Firebase 项目 > 选择具体的项目应用 > 设置 > 服务账号 > Firebase Admin SDK，单击生成新的私钥，获取到 Firebase 服务器私钥 json 文件。然后进入 移动推送控制台 > 配置管理 > 基础配置 > FCM 官方推送通道 栏目中，选中“（推荐）服务器私钥”，单击点击上传，上传获取到的 json 文件。注意：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:24.0.1' //在应用级的 gradle 文件的最后一行代码中新增并将 google-services.json 放进您应用 module 的根路径下apply plugin: 'com.google.gms.google-services'注意：FCM 推送 [VERSION] 为当前 SDK 版本号，版本号可在 Android SDK 发布动态 查看。Google 配置 google-play-services（建议版本 24.0.1+，较低版本有可能出现无法注册 FCM 风险）。启用 FCM 推送在调用移动推送注册代码 XGPushManager.registerPush 前，添加以下代码设置：XGPushConfig.enableOtherPush(this, true);注册 FCM 成功的日志如下：V/TPush: [XGPushConfig] isUsedOtherPush:trueI/TPush: [OtherPush] checkDevice pushClassNamecom.tencent.android.tpush.otherpush.fcm.impl.OtherPushImplI/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 在前台接收。什么是强制停止应用进程？在手机设置-应用管理-具体应用-点击“结束运行”/“强制停止”等按钮停止了应用。大部分国内品牌手机，在多任务页面划掉应用进程，也可认为是强制停止了应用进程（境外手机不会）。上一篇: 魅族通道接入下一篇: vivo 通道接入Copyright © 2013-2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有深圳市腾讯计算机系统有限公司ICP备案/许可证号：粤B2-20090059粤公网安备44030502008569号腾讯云计算（北京）有限责任公司京ICP证150476号 | 京ICP备11018762号中国站中文International文档“捉虫”活动检视指定产品文档，发现和反馈有效问题，奖！API专项"捉虫"反馈API文档问题，代金券、周边好礼奖不停！文档建议，你提了吗快来使用腾讯云产品文档，提出有效建议，奖！在线咨询目录返回顶部