版权声明:

本账号发布文章均来自公众号,承香墨影(cxmyDev),版权归承香墨影所有。

每周会统一更新到这里,如果喜欢,可关注公众号获取最新文章。

未经允许,不得转载。

一、前言

推送服务在国内有很多服务商,但是如果是做海外 App ,推荐还是使用 Google 自己的推送服务,毕竟海外常用的手机型号,都是有 Google 服务在的。

Google 的推送服务,以前叫做 GCM(Google Cloud Message)。而自从 Google 将 Firebase 收购之后,就将推送服务并到 Firebase 的一项服务中了,现在叫做 FCM。

本文就在 Android 下,集成 FCM 的过程,做一个详尽的讲解。

二、什么是 Firebase

Firebase 原本是一家实时后端数据库的创业公司,主要用于帮开发者快速的写出 Web 端和移动端的应用,类似于国内 Bmob 这种后端云服务,让前端或者客户端开发者,一行服务端代码都不用写,只需要简单的配置,就可以快速的开发出一款引用来。

Bmob 我也只是看了文档,没有实际使用过,具体怎么样不做评价。

之后 Firebase 被 Google 收购,开始使用 Google 的云服务,又增加了一些 Google 本身的服务,更丰富了它的功能。

Firebase 除了支持 Android 之外,也支持其他的一些语言和平台,例如:iOS、C++、Unity。

基本上你能想到的功能,Firebase 都是支持的,主要我觉得比较好用的功能:授权登录、推送、实时数据库、CDN存储、崩溃报告、事件统计、带回源的动态邀请、广告、推广等。

所以如果你需要开发一款在海外使用的 App 的话,Firebase 是一个不错的选择,Firebase 采用的是模块化集成,使用到什么功能,就集成什么功能即可。

有关 Firebase 详细的内容,可以参见官方文档:

https://firebase.google.com/d...

只要需要用到 Firebase 的功能,前提就是必须将 Firebase 的基础服务集成到项目中。

Firebase 的集成非常的简单,只需要注册一个 Google 帐号,然后在其中新建一个 App ,配置好对应的配置,将 App 的 google-service.json 这个配置文件下载下来,放在项目的对应位置即可。

没什么好细说的,直接看官方文档,一步一步走就可以了。

https://firebase.google.com/d...

最终生成的 App 大概是这样的:

/fcm-app.png

在设置里就可以下载 google-services.json 文件。

/fcm-googlejson.png

三、使用 FCM

到这里,基本上就认为你已经成功集成 Firebase 到你的项目内了,接下来就开始集成 FCM 的模块了。

3.1 设置 Firebase 和 FCM SDK

在 build.gradle 文件,添加 FCM 的依赖。

/fcm-gradle.png

官方的例子中使用的是 10.2.6,但是实际上推荐使用新版 11.0.4 。

3.2修改 AndroidManifest.xml

FCM 主要的两个 Service ,都需要在 Manifest 中进行配置。

1、继承自 FirebaseMessagingService 的服务。

它主要用于处理接收 App 正在运行的时候,接收到的推送,一般而言我们也不会只是想要接收 App 不在运行时候的推送,所以通常都需要集成它。

/fcm-messageservice.png

2、继承 FirebaseInstanceIdService 的服务。

它主要用于管理 FCM 的注册令牌(下文简称 FCM_TOKEN ),以及更改等。它可以获取到用户设备唯一的一个 FCM_TOKEN ,向单个用户推送消息的时候使用。

/fcm-idservice.png

3.3 FCM 中两个关键服务

1、MyFirebaseMessagingService

先来看看它的结构。

/fcm-msgservice.png

这里,我们真正需要关心的只有 onMessageReceived() 方法,它会在接收到推送的时候被回调。注意这里的方法都是在 WorkerThread 线程中完成的,所以要额外注意操作 UI 的情况。

onMessageReceived() 方法的回调中,会传递一个 RemoteMessage 的对象,它包含了接收到的推送的所有内容。我们需要根据这个推送传递过来的信息,进行额外的操作。例如:弹窗提醒、创建一个 Notification 等等。

2、MyFirebaseInstanceIDService

继续看看它的结构。

/fcm-ids.png

其实内部有一些被混淆了的方法,但是我们真正关心的只有 onTokenRefresh() 这一个方法,它会在 FCM_TOKEN(文档里叫令牌) 被刷新的时候回调。

正常来说,App 启动的时候,会被分配一个 FCM_TOKEN ,它可以通过 FirebaseInstanceId.getInstance().getToken() 这个 Api 获取到,但是它并非一成不变的,当它变动的时候,就会回调 onTokenRefresh() 方法。所以如果有对单个用户推送的业务逻辑的话,这里就需要上报给你的服务端,当前用户的 FCM_TOKEN 了。

到这里,基本上就算是完成了 FCM 的集成,具体细节,建议查看官方文档。

https://firebase.google.com/d...

3.4 开始尝试推送

当你一切都配置完成之后,你就可以在 Firebase 的后台,Notifications 的模块,进行消息的推送。(也可能是由服务端来实现推送功能)

首先你需要配置一个内容,就是 Message text

/fcm-messagetext.png

当然,FCM 和众多推送一样,同时支持推送所有用户、Topic 分组、单个设备,这里只推送我指定的设备。

/fcm-target.png

还可以为 FCM 推送消息配置一个 Title ,并且它是支持最新 Android O 中支持的 Notification Channel 的配置。如果有需要,可以再配置传递的参数。

/fcm-params.png

点击 SEND MESSAGE 按钮,你就可以在设备上收到你的推送消息。

/fcm-noti1.png

展开后的效果:

/fcm-noti5.png

到这里,基本上算是完成的 FCM 的集成与使用。

四、FCM 使用的坑

前面的内容,基本上都是你在官方文档上能查阅到的,接下来讲的,就是干货中干货。说是干活,就是使用过程中遇到的一些坑。

4.1 App 是否运行,决定了推送走的两条线路

App 在运行的时候,推送如果有 Notification ,一般也是我们自己去控制的,所以最终它点击后的效果,我们是可以通过 PendingIntent 做部分定制的。

但是如果是在 App 没有运行的情况下,就完全归 FCM 服务帮你完成这一系列的操作,它点击后的效果,只能将你的 App 调起,并且把你需要的参数传递到你的 SplashActivity(Action 为 android.intent.action.MAIN 的 Activity) 上。

所以我们就需要考虑两种情况下,数据的传递已经响应,这个是需要根据业务来讨论的,空聊是没有意义的。

4.2 推送服务的 icon 和 字体颜色

前面看到,使用 FCM 如果在 App 没有运行的情况下,是完全不受控的。但是 FCM 依然为我们提供了配置 icon 的地方,如果你不配置,你将会受到一个白色的小方块图标的推送。

/fcm-noti3.png

FCM 的推送通知,可以配置 icon 以及 App 名称的颜色,像前面 Demo 的例子中,就是直接使用 Firebase 的 Github 上的 Demo 的图片。

对 icon 和 字体颜色的配置,需要在 AndroidManifest.xml 中进行。

/fcm-icon.png

还有一点需要注意,通常我们 App 的 Icon 都做的非常的精美,但是这种 Icon 是无法直接使用在 FCM 的推送上的。需要额外的定制,以及对应的尺寸。

FCM Icon 的标准:背景透明,以白色图案填充。(实际上,展开后的效果会将icon 进行着色,所以任何颜色最终都会被着色成我们配置的颜色,不配置默认是个浅灰色)。

/fcm-icondemo.png

而它的尺寸,如下表所示:

当然,它和图标的适配一样,不一定需要全套,只需要配置我们需要的尺寸即可。

如果配置好这些,依然得到的是一个白色的小块,可以尝试升级一下 FCM 的版本,低版本好像是有这个 Bug ,在新版已经解决了。

五、结语

到这里基本上 FCM 的一些使用细节都讲解清楚了。如果还有问题,推荐查阅官方文档或者直接看 Github 上的 Demo 。

https://github.com/firebase/q...

其实整体来看 Firebase 提供的服务,使用起来都非常的方便。如果一直收不到推送,检查你的上网方式,毕竟是给海外 App 使用的。再有问题,可以文末留言。等你问我的时候我还记得的话,我肯定会回复你的。

公众号二维码.jpg

点赞或者分享吧~


plokmju88
1.5k 声望132 粉丝

大家好,我是承香墨影。