> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 申请开通FCM推送引导

> 申请开通 FCM 推送服务，让专属钉钉 App 在国外手机接收离线消息，涵盖注册 Firebase、创建服务账号密钥与实时数据库并向钉钉提交物料。

FCM（Firebase Cloud Messaging）是一个跨平台的消息解决方案，支持Android/iOS/Web端，是GCM(Google Cloud Messaging) 的一种增强版本。

当专属APP期望能够在国外手机接收到离线推送消息时，请申请FCM并提供相关物料。

***

## 申请开通FCM

<Steps>
  <Step title="（1）申请开通Google开发者账号" />

  <Step title="（2）注册Firebase">
    在Firebase创建project 并注册应用，注册地址：[https://console.firebase.google.com/](https://console.firebase.google.com/)

    创建好项目后，选择Android图标，配置Android应用：

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/31d942c8-486b-4c24-a2fb-dc73e486d5fc.png" alt="在Firebase配置Android应用" />
    </Frame>

    <Note>
      请注意：

      * "Android package name"： 请填写正确的专属钉钉包名
      * "App nickname"（可选）：请填写专属钉钉名字
    </Note>

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/ZWGl05KJJPvmDn34/img/16b878cb-579b-4b6d-a91b-de54a1fdc40f.png" alt="填写Android包名和应用昵称" />
    </Frame>
  </Step>

  <Step title="（3）下载配置文件并上传到钉钉OA打包平台">
    点击下载：google-services.json，请保存文件并发给钉钉技术配置。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/22c5b047-c9e5-446b-a305-a28d97a6b93f.png" alt="下载google-services.json" />
    </Frame>
  </Step>

  <Step title="（4）进入控制台配置其他参数">
    直接进入最后一步，前往控制台

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/e525e9d1-eb2f-4d98-9a07-4d05788c384d.png" alt="前往控制台" />
    </Frame>
  </Step>

  <Step title="（5）创建服务账号密钥">
    选择项目设置 - 服务账号 - 生成密钥，如下图：

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/3aa274ea-2364-4406-8508-97d4b564c1c3.png" alt="项目设置、服务账号、生成密钥" />
    </Frame>

    <div style={{display: 'flex', gap: '12px', justifyContent: 'center', flexWrap: 'wrap', margin: '16px 0'}}>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/3aa2ab85-2a68-4d39-88f3-a9786fd93d54.png" alt="生成私钥对话框" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />

      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/fccc3bd5-e635-43d9-9bcc-71b999c20c39.png" alt="确认生成私钥" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />
    </div>

    点击生成密钥后会自动生成一个json文件，请将json文件保存并发送给钉钉技术：

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/adb6ae9a-4fa7-4764-87af-5dd4afd82d38.png" alt="生成的服务账号密钥json文件" />
    </Frame>
  </Step>

  <Step title="（6）申请实时数据库（Realtime Database）">
    点击创建数据库：

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/169b982d-35a9-457b-86b4-d122a41529d3.png" alt="创建数据库" />
    </Frame>

    <div style={{display: 'flex', gap: '12px', justifyContent: 'center', flexWrap: 'wrap', margin: '16px 0'}}>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/31428bb0-eedb-4560-bfc9-9dae66c668aa.png" alt="实时数据库设置步骤" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />

      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/1f9f3fbf-dc40-4c05-b55f-a5cedb3fad50.png" alt="实时数据库规则步骤" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />
    </div>

    点击启用，拷贝数据库地址作为打包物料。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/97870976-6475-4696-bf5e-7924bd147cd1.png" alt="拷贝数据库地址" />
    </Frame>
  </Step>

  <Step title="（7）请将以上物料提供给钉钉方配置">
    <Check>
      * google-services.json
      * 密钥json文件
      * 实时数据库地址
    </Check>
  </Step>

  <Step title="（8）打包完成后可到Firebase平台发起测试验证（可选）">
    <Note>
      **注意：该步骤可以不执行。**
    </Note>

    为了验证FCM，我们必须提前准备一台具有Google推送服务的手机（建议国外版Pixel）。进入后台，选择 Cloud Messaging。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/1a6513d9-bd98-484c-9399-3b5edc9a2c18.jpg" alt="在后台选择 Cloud Messaging" />
    </Frame>

    然后一步步按照提示发送测试通知（请注意，务必只能在上线前测试，避免消息被全员推送导致引起故障）。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/aaff376b-8259-411a-a17f-26051fe14304.jpg" alt="发送测试通知" />
    </Frame>

    发送后手机将收到测试通知，代表申请成功：

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/fb12f2da-5680-4df3-a285-e394f73f979a.png" alt="手机收到测试通知" />
    </Frame>
  </Step>
</Steps>