tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
移动推送
    文档
    Download PDF

    FCM 通道接入

    最后更新时间：2024-01-16 17:39:39
    下载PDF

      操作场景

      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。
      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. 在应用级的 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'
      注意：
      1. FCM 推送 [VERSION] 为当前 SDK 版本号，版本号可在 Android SDK 发布动态 查看。
      2. 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 在前台接收。

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

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

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款