Noob Android Developer

0%

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

为什么要接入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" />

更多自定义内容请参考: