为什么要接入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" />
更多自定义内容请参考: