Java服务端集成Google FCM推送的注意事项和实际经验

公司的app要上海外，涉及到推送功能，经过综合考虑，选择Google FCM进行消息推送。

查看一些集成博客和官方文档，看的似懂非懂，迷迷惑惑。本篇文章除了将我实际集成的经验分享出来，也会对看到的博客及其中产生的疑惑、注意事项一一评论。

从官方文档和众多博客中，你会发现Java集成FCM推送有多种实现方式，会让生产生文档很乱，不知作何选择的困惑。

1.http://t.csdn.cn/hxNqh，这篇文章告诉你集成推送为何要创建Firebase项目。看后豁然开朗，介绍了FCM有两种消息: Data Message和 Notification Message.就是透传消息和通知栏消息。根据实际测试，只有app在前台的时候由app应用进行发送通知消息，当app在后台的时候由系统弹通知栏，当app被杀死的时候，从Firebase后台发送是收不到的，因为控制台只能发送通知栏消息，所以收不到，但是通过后端集成是可以让杀掉的app收到推送的。

作者文章出现了以下集成方式

 Firebase后台发送是收不到的
  1 http请求：
  2 https://fcm.googleapis.com/fcm/send
  3 
  4 Content-Type:application/json
  5 Authorization:key= App Key
  6 {
  7     "notification" : {
  8       "body" : "You have a new message",
  9       "title" : "",
 10       "icon" : "app icon"
 11     },
 12     "to" : "user token"
 13 }
 （2）Data Message：
 不管app在后台还是前台都会走这个方法。
  1 http请求：
  2 https://fcm.googleapis.com/fcm/send
  3 
  4 Content-Type:application/json
  5 Authorization:key= App Key
  6 {
  7     "data" : {
  8       "request" : "1",
  9       "xxx" : "xxx"
 10     },
 11     "to" : "user token"
 12 }

看官方文档，也有该种方式，由于一开始接触官方文档是通过SDK的方式进行的，该种api的方式给我带来困惑，怎么还有这种方式集成吗，后来了解到，这是http的方式调用的，而sdk集成是封装好的，不可混用。测试时，用该种http方式非常方便，尤其是进行透传消息Data Message测试时，很方便，但是我没发送成功，可能还是国内环境的问题。多种调用方式当时也困惑了我很久，因为官方文档介绍集成时是sdk和http调用、以及oauth一起介绍的，弄晕了，用哪种是对的呢。根据集成便捷及使用性当然首选SDK的方式集成。

 如果想了解更多http服务器调用API的方式可看http://t.csdn.cn/dOn5y

1.2admin-sdk导入采用了方便的maven进行sdk集成

<dependency> <!-- 谷歌推送依赖 -->
    <groupId>com.google.firebase</groupId>
    <artifactId>firebase-admin</artifactId>
    <version>6.10.0</version>
</dependency>

1.3.在进行FirebaseApp.initializeApp(options)时，如下

ClassPathResource classPathResource = new ClassPathResource("{firebase下发的json}");
 FirebaseOptions options = new FirebaseOptions.Builder()
 .setCredentials(GoogleCredentials.fromStream(inputStream))
 .setDatabaseUrl("https://<DATABASE_NAME>.firebaseio.com/")//
 .build();
  firebaseApp = FirebaseApp.initializeApp(options)时

不管多个博客还是官方文档，都有.setDatabaseUrl("https://<DATABASE_NAME>.firebaseio.com/")这个调用，我在集成时，这个到底要不要填写时，很少困惑，把握不准，没有一个地方说这个方法是否使用，如果使用，这个DatabaseUrl应该如何配置，最后在实际的测试过程中，结论是如果是单独集成FCM的推送功能，setDatabaseUrl可以完全去掉不写，一点也不影响Firebase的初始化和消息的推送.

而最终的初始化如下：

  @PostConstruct
     public void init() {
         try {
             //initProxy("127.0.0.1", 8089);
             ClassPathResource cpr = new ClassPathResource("serviceAccountKey.json");
             InputStream inputStream = cpr.getInputStream();
             FirebaseOptions options = FirebaseOptions.builder()
                     .setCredentials(GoogleCredentials.fromStream(inputStream))
                     .build();
             //初始化firebaseApp
             firebaseApp = FirebaseApp.initializeApp(options);
         } catch (Exception e) {
             log.error("google FirebaseApp initializeApp fail = {}", e);
         }
     }

serviceAccountKey.json获取和在项目中存放的位置

​​​​​​​

2.http://t.csdn.cn/e8QjT，这篇文章通过详细的图文介绍了Firebase平台如何创建一个安卓项目，如何配置，安卓端如何使用，在Firebase的网页控制台，如何进行通知消息的测试。但是呢，这篇文章没有说，管理台发的消息只能是通知栏消息，不能发透传消息（有的又叫数据消息），也没有有介绍到服务端如何集成，但是创建Firebase安卓项目还是可以参考的

题外话：Firebase平台创建好Android项目时，Google Play会自动生成一个Android应用项目，不过没包名，在Google Cloud平台会生成集成三方登录的所需要的秘钥等信息，三方登录和支付理解起来比推送更复杂，看文档和博客让人更困惑，此处暂时不细表。

如果仅仅推送通知栏消息，app杀掉、进程不再时就不收到通知，可以用通知栏消息 Notification Message.

Message message = Message.builder()
     .setNotification(Notification.builder()
         .setTitle("我是push标题")
         .setBody("我是你push的内容")
         .build())
     //.putAllData(map);
     .setToken(registrationToken)
     .build();
 String response = FirebaseMessaging.getInstance(firebaseApp).send(message);

如果想要app杀掉后，进程不在也能收到push,可以使用透传消息Data Message，实际测试中发现，data透传有的手机杀掉能收到，有的收不到。

 Message message = Message.builder()
     .putData("title", "我是push标题")
     .putData("body", "我是push内容")
     //.putAllData(map);
     .setToken(registrationToken)

     .build();
 String response = FirebaseMessaging.getInstance(firebaseApp).send(message);

如果setNotification和data一起传递，是通知栏消息。

使用透传，通知栏的显示最终都要由Android端主动send才会显示出来。

3.FCM实现消息推送，介绍了官方FCM推送api的github地址：GitHub - firebase/firebase-admin-java: Firebase Admin Java SDK，集成的是 AndroidConfig androidConfig=androidConfigBuilder.build();讲了如果多个app调用fcm服务，采用一个map来保存每个 app对应的FirebaseApp信息；也介绍了代理的方法，在发送之前，一定需要进行参数设置，让请求走代理方式，因为谷歌的服务器在国内都是被禁的。

这篇文章给我带来了很多困惑，难道安卓实现推送，还得专门这样写吗，后端还得拿到安卓端的图标、铃声、通道、跳转页面等等，一堆繁琐的配置，不走代理不行吗。json格式文件哪来的，需要手动配置吗。最后开发完了，回头看官方文档，才明白，androidConfigBuilder.build();这种集成方式是针对安卓设备进行推送，给安卓设备推送，可用可不用该种方式，根据实际集成便捷性来看，果断否定了该种集成方式。

而使用了最普遍的发送方式，如2.介绍的通知栏和透传实现。当然仅仅介绍的是单个设备的发送。如果想了解多个设备、订阅等其他方式，官方文档介绍的就非常好。