Noob Android Developer

0%

发表于

为什么要接入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.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
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进行注册。

1
2
3
4
5
<service android:name="com.test.fcmdemo.MessageService">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>
  • 在第4步中，我们进行获取Token，在MainActivity中调用以下接口
1
2
3
4
5
6
7
8
9
10
11
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中获取数据。

1
2
3
4
5
6
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进行申明
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
/**
 * 初始化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
1
2
3
<meta-data
android:name="com.google.firebase.messaging.default_notification_channel_id"
android:value="ChannelId" />

更多自定义内容请参考：