原生移动开发 / 系统课时
在 Android 项目接入 FCM
在 Android 项目接入 FCM
本课完成一个 Android 客户端接入 FCM 的最小闭环:绑定 Firebase 项目、加入 Messaging SDK、放置配置文件,并声明消息服务。完成后即可从客户端取得当前注册标识并进入后续推送验证。
学习目标
- 能正确完成 Firebase 项目与 Android 应用的关联
- 能加入 Firebase Messaging 依赖并放置
google-services.json - 能声明
FirebaseMessagingService,验证客户端已建立 FCM 注册
配置 Firebase 与 Android 应用
先在 Firebase 控制台创建或选择项目,再添加 Android 应用。注册时使用 Android 工程实际的 application ID,例如 com.example.pushdemo。下载得到的 google-services.json 放在 Android 应用模块的 app/ 目录。该文件包含项目关联所需的非机密标识,不能用别的 Firebase 项目文件替代。([Firebase][1])

加入 Messaging SDK
当前 Firebase Android 项目建议使用 Firebase BoM 统一 Firebase 库版本;Google services Gradle plugin 负责处理 google-services.json。以下是 build.gradle.kts 的典型配置片段,假设工程已经配置好 Android Gradle Plugin 与 Kotlin。
// 项目级 build.gradle.kts:声明 Google services 插件版本
plugins {
id("com.google.gms.google-services") version "4.5.0" apply false
}
// app/build.gradle.kts
plugins {
id("com.android.application")
kotlin("android")
id("com.google.gms.google-services")
}
dependencies {
implementation(platform("com.google.firebase:firebase-bom:34.19.0"))
implementation("com.google.firebase:firebase-messaging")
}预期结果
Gradle sync succeeds and firebase-messaging is resolved from the Firebase BoM.不要同时给 firebase-messaging 再手写独立版本,否则会绕过 BoM 的统一版本管理。Google services 插件与 Firebase BoM 的当前官方文档均采用这种管理方式。([Firebase][2])
声明消息服务
只有需要在前台接收消息、处理 data payload 或自定义消息处理时,才需要显式扩展 FirebaseMessagingService。在 Manifest 中声明服务,并绑定 com.google.firebase.MESSAGING_EVENT。
<application
...>
<service
android:name=".MyFirebaseMessagingService"
android:exported="false">
<intent-filter>
<action android:name="com.google.firebase.MESSAGING_EVENT" />
</intent-filter>
</service>
</application>MyFirebaseMessagingService 的包名必须与工程实际类路径一致;android:exported="false" 表示该服务不作为应用外部组件导出。官方接收消息文档要求使用这一消息事件入口。([Firebase][3])
验证 FCM 基础注册
安装并启动应用后,可在应用代码中主动读取当前 FCM registration token,先确认客户端已经能够向 FCM 完成注册。
import android.util.Log
import com.google.firebase.messaging.FirebaseMessaging
fun verifyFcmRegistration() {
FirebaseMessaging.getInstance().token
.addOnCompleteListener { task ->
if (!task.isSuccessful) {
Log.e("FCM", "Fetching FCM registration token failed", task.exception)
return@addOnCompleteListener
}
val token = task.result
Log.d("FCM", "FCM token available: ${token.take(12)}...")
}
}预期结果
FCM token available: <TOKEN_PREFIX>...实际 token 是动态值,不要把完整 token 写死在代码或截图中。当前 Android 文档仍提供 getToken() 与 onNewToken() 的 token 管理方式,同时官方文档正在推进以 Firebase Installation ID 为基础的注册管理,因此新项目应留意后续 API 迁移。([Firebase][3])
完成这些步骤后,客户端已经具备 FCM 基础接入条件;后续真正发送消息时,还需要继续处理 token 保存、刷新与服务端同步。