Android系统级推送 - Firebase Cloud Messaging(FCM)快速傻瓜式接入

5,887 阅读3分钟

为什么要接入FCM

越来越多的国内厂商开始开拓海外市场,海外市场的Android设备绝大部分是接入了Google Service,所以在海外市场Android设备上使用最多以及最好使用的就是Google的推送了。

接入前准备

需要科学上网,以及Android设备安装Google服务
需要科学上网,以及Android设备安装Google服务
需要科学上网,以及Android设备安装Google服务

  • 新建一个测试项目

通过Android Studio 自带工具进行接入

  • 选择Firebase
  • 选择Cloud Messaging

在这里按照文档给出的提示分别进行1、2、3步骤进行集成即可。

  • 在第1步中,我们需要在Firebase新建一个项目,同时选择国家地区。
  • 在第2步中,我们只要点击Accept Changes即可,等待Sync Project完成
  • 在第3步中,我们需要新建一个MessageService继承于FirebaseMessagingService.
public class MessageService extends FirebaseMessagingService {

    private final String TAG = "FCMDemo";

    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
    
        // 当APP未被kill时,推送消息在这里进行处理
        Log.d(TAG, "From: " + remoteMessage.getFrom());

        // Check if message contains a data payload.
        if (remoteMessage.getData().size() > 0) {
            // 推送中所含的键值对都可以在这里进行获取
            Log.d(TAG, "Message data payload: " + remoteMessage.getData());
        }

        // Check if message contains a notification payload.
        if (remoteMessage.getNotification() != null) {
            // 如果推送消息仅为通知消息,这里将获取通知消息的内容
            Log.d(TAG, "Message Notification Body: " + remoteMessage.getNotification().getBody());
        }
    }
    
    @Override
    public void onNewToken(String s) {
        super.onNewToken(s);
        // 当Token发生改变时,通过这个函数获取最新的Token
        Log.d(TAG, "new Token: " + s);
    }
}

同时,不要忘记在AndroidManifest对MessageService进行注册。

<service android:name="com.test.fcmdemo.MessageService">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>
  • 在第4步中,我们进行获取Token,在MainActivity中调用以下接口
FirebaseInstanceId.getInstance()
          .getInstanceId()
          .addOnCompleteListener(task -> {
              if (!task.isSuccessful()) {
                  Log.e("FCMDemo", "getInstanceId failed", task.getException());
                  return;
              }
              // Get new Instance ID token
              String token = task.getResult().getToken();
              Log.e("FCMDemo", "token: " + token);
          });

然后启动APP,在Logcat中查看,就可以拿到Token,拿到Token当然要测试一下推送啦

后台进行推送测试

  • 首先打开 FCM控制后台

  • 选择我们创建的项目,选择Cloud Messaging

  • 编写通知内容,选择发送测试消息

  • 添加测试Token

  • 点击测试按钮,在Android设备上即可接收到推送消息

  • Tips: 如果没接收到推送消息,请参考下列情况
    1.App在前后台都没有收到任何消息。可能是Android设备没有科学上网(部分地区手机4G网络可以接收到推送消息)。
    2.App在前台,通知栏没有消息显示。当App在前台的时候,推送消息将由我们前面创建的MessageService进行管理,
    如果要创建通知,则需要我们手动创建。

  • 通知消息处理,如果通知消息中含有自定义消息,App在前台时,在MessageService中getData获取Map通过键值获取数据。 在通知栏消息处理,需要在LaunchActivity中的Intent中获取数据。

if (getIntent().getExtras() != null) {
            for (String key : getIntent().getExtras().keySet()) {
                Object value = getIntent().getExtras().get(key);
                Log.d("FCMDemo", "Key: " + key + " Value: " + value);
            }
        }
  • Android 8.0 以上版本推荐使用通知渠道处理,所以我们需要创建一个default通知渠道,同时我们要在AndroidManifest进行申明
    /**
     * 初始化Channel
     */
    private void initChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {

            /*AudioAttributes attributes = new AudioAttributes.Builder()
                    .setUsage(AudioAttributes.USAGE_NOTIFICATION)
                    .build();*/
            //创建通知渠道
            //渠道id
            //重要性级别
            NotificationChannel mChannel = new NotificationChannel("ChannelId",
                    "ChannelName",
                    NotificationManager.IMPORTANCE_DEFAULT);

            //渠道描述
            mChannel.setDescription("Channel desc");
            //是否显示通知指示灯
            mChannel.enableLights(true);
            //是否振动
            mChannel.enableVibration(true);
            // 设置通知声音
            //mChannel.setSound(Uri.parse("android.resource://" + getPackageName() + "/" + R.raw.bell), attributes);
            //创建通知渠道
            NotificationManager notificationManager = (NotificationManager) getSystemService(
                    NOTIFICATION_SERVICE);
            notificationManager.createNotificationChannel(mChannel);
            notificationManager.cancelAll();
        }
    }
  • AndroidManife.xml
            <meta-data
            android:name="com.google.firebase.messaging.default_notification_channel_id"
            android:value="ChannelId" />

更多自定义内容请参考: