Google FireBase - fcm 推送 (Cloud Messaging)

要將 Firebase 添加到您的應用，您需要有一個 Firebase 項目以及適用於您的應用的 Firebase 配置文件。

1. 如果您還沒有 Firebase 項目，請在 Firebase 控制台中創建一個。如果您已經有與自己的移動應用相關聯的現有 Google 項目，請點擊導入 Google 項目。如果沒有，請點擊添加項目。
2. 點擊將 Firebase 添加到您的 Android 應用，然后按設置步驟操作。如果您是導入現有 Google 項目，系統可能會自動執行這些操作，您只需下載配置文件即可。
3. 出現提示時，輸入應用的軟件包名稱。請務必輸入應用在使用的軟件包名稱；只有在將應用添加到 Firebase 項目時您才能進行此設置。
4. 最后，您要下載一個 google-services.json 文件。您可以隨時重新下載此文件。
5. 如果尚未將此文件復制到項目的模塊文件夾（通常是 app/），請執行此操作。

在“根級別”的build.gradle文件添加一條規則。以包含Google服務插件：

buildscript {
    
    repositories {
        jcenter()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:2.3.3'

        classpath 'com.google.gms:google-services:3.2.0'
    }
}

allprojects {
    repositories {
        maven { url 'https://maven.google.com' }
        mavenCentral()
        jcenter()
    }
}

然后在模塊Gradle文件中(比如app模塊下)，底部添加apply plugin行，以啟用 Gradle 插件：

apply plugin: 'com.android.application'

android {
     // ...
}

dependencies {
    // ...

    compile 'com.google.android.gms:play-services-base:11.4.0'
    // Google Firebase cloud messaging
    compile 'com.google.firebase:firebase-messaging:11.4.0'

}

apply plugin: 'com.google.gms.google-services'

自定義 ECFCMMSGService 繼承  FirebaseMessagingService , 重寫 onMessageReceived方法接收通知消息彈通知欄

FCM有兩種消息: Data Message和 Notification Message.

（1）Notification Message ：

只有app在前台的時候才會走這個方法，當app在后台的時候由系統彈通知欄，當app被殺死的時候，從Firebase后台發送是收不到的

http請求：
https://fcm.googleapis.com/fcm/send

Content-Type:application/json
Authorization:key= App Key
{
    "notification" : {
      "body" : "You have a new message",
      "title" : "",
      "icon" : "app icon"
    },
    "to" : "user token"
}

（2）Data Message：

不管app在后台還是前台都會走這個方法。

http請求：
https://fcm.googleapis.com/fcm/send

Content-Type:application/json
Authorization:key= App Key
{
    "data" : {
      "request" : "1",
      "xxx" : "xxx"
    },
    "to" : "user token"
}

（3）Messages with both notification and data payload：

這種消息是在Notification Message的基礎上加入一些數據，在用戶點擊通知欄的時候啟動對應的activity並傳入intent。

public class ECFCMMSGService extends FirebaseMessagingService {

    // 它主要用於處理接收 App 正在運行的時候，接收到的推送

    private static final String TAG = "ECFCMMSGService";

    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        super.onMessageReceived(remoteMessage);

        // 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());

            sendNotification(remoteMessage.getNotification().getBody());
        }
    }

    private void sendNotification(String messageBody) {

        Intent intent = new Intent(this, MainActivity.class);
        intent.putExtra("key", messageBody);
        intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);

        PendingIntent pendingIntent = PendingIntent.getActivity(this, 0 /* Request code */, intent,
                PendingIntent.FLAG_ONE_SHOT);

        Bitmap icon2 = BitmapFactory.decodeResource(getResources(),
                R.mipmap.app_logo);

        Uri defaultSoundUri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);
        NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(this)
                .setSmallIcon(R.mipmap.app_logo)
                .setContentTitle("You have a new message.")
                .setContentText(messageBody)
                .setAutoCancel(true)
                .setLargeIcon(icon2)
                .setSound(defaultSoundUri)
                .setContentIntent(pendingIntent);

        NotificationManager notificationManager =
                (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);

        notificationManager.notify(new Random().nextInt() /* ID of notification */, notificationBuilder.build());
    }
}

自定義 ECFCMTokenRefreshService 集成 FirebaseInstanceIdService.

用戶token的創建，轉換和更新，在onTokenRefresh()方法中獲取token並上傳到服務器。

public class ECFCMTokenRefreshService extends FirebaseInstanceIdService {

    // 它主要用於管理 FCM 的注冊令牌（下文簡稱 FCM_TOKEN ），以及更改等。它可以獲取到用戶設備唯一的一個 FCM_TOKEN ，向單個用戶推送消息的時候使用

    private static final String TAG = "FCMTokenRefreshService";

    private ApiService mService;
    private float mRequestTime = 0;
    private int mErrorCount = 0;
    private int REQUEST_ERROR_MAX = 10;
    private TreeMap<String, Object> mParams;

    @Override
    public void onCreate() {
        super.onCreate();

        if (PreferencesUtils.getInstance().isFCMTokenSendServiceSuccess()) {
            return;
        }

        String token = PreferencesUtils.getInstance().getFcmToken();

        if (TextUtils.isEmpty(token)) {
            token = FirebaseInstanceId.getInstance().getToken();
        }

        sendFCMTokenToServer(token);
    }

    @Override
    public void onTokenRefresh() {
        super.onTokenRefresh();

        PreferencesUtils.getInstance().saveFCMTokenSendServiceSuccess(false);

        String token = FirebaseInstanceId.getInstance().getToken();
        Log.i(TAG, "onTokenRefresh: " + token);
        // Important, send the fcm token to the server
        sendFCMTokenToServer(token);
    }

    // http://ebike-test.zriot.net/shop-app/push/token
    private void sendFCMTokenToServer(final String token) {

        if (TextUtils.isEmpty(token)) {
            return;
        }

        if (mService == null) {
            mService = RetrofitHelper.getInstance().getApiService(ApiService.class);
        }

        PreferencesUtils.getInstance().saveFCMToken(token);

        if (!AccountManager.getInstance().isUserLogin()) {
            return;
        }

        if (mParams == null) {
            mParams = new TreeMap<>();
        }

        if (mParams.size() == 0) {
            mParams.put("uid", AccountManager.getInstance().getUserId());
            mParams.put("token", AccountManager.getInstance().getToken());
            mParams.put("fcmToken", token);
            mParams.put("osType", "1"); // 1: android 2 : ios 70         }

        mService.sendFCMTokenToServer(mParams)
                .subscribeOn(Schedulers.io())
                .unsubscribeOn(Schedulers.io())
                .observeOn(AndroidSchedulers.mainThread())
                .subscribeWith(new DisposableObserverCallBack<BaseResponse>() {
                    @Override
                    public void onNext(@NonNull BaseResponse response) {

                        if (response == null) {
                            return;
                        }

                        if (response.isRequestSuccess()) {
                            PreferencesUtils.getInstance().saveFCMTokenSendServiceSuccess(true);
                        }

                        mErrorCount = 0;
                    }

                    @Override
                    public void onError(Throwable e) {
                        super.onError(e);

                        if (mErrorCount >= REQUEST_ERROR_MAX) {
                            return;
                        }

                        if (!allowRequest()) {
                            return;
                        }

                        sendFCMTokenToServer(token);

                        mErrorCount += 1;
                    }
                });
    }

    private boolean allowRequest() {

        if (mRequestTime == 0) {
            mRequestTime = System.currentTimeMillis();
            return true;
        }

        if (System.currentTimeMillis() - mRequestTime < 3000) {

            return false;
        } else {

            mRequestTime = System.currentTimeMillis();
            return true;
        }
    }

}

在android清單文件中：注冊service：

　　　　　<service android:name=".fcm.ECFCMMSGService"
            android:stopWithTask="false">
            <intent-filter>
                <action android:name="com.google.firebase.MESSAGING_EVENT" />
            </intent-filter>
        </service>

        <service android:name=".fcm.ECFCMTokenRefreshService"
            android:stopWithTask="false">
            <intent-filter>
                <action android:name="com.google.firebase.INSTANCE_ID_EVENT" />
            </intent-filter>
        </service>

注意：

App 是否運行，決定了推送走的兩條線路

App 在運行的時候，推送如果有 Notification ，一般也是我們自己去控制的，所以最終它點擊后的效果，我們是可以通過 PendingIntent 做部分定制的。

但是如果是在 App 沒有運行的情況下，就完全歸 FCM 服務幫你完成這一系列的操作，它點擊后的效果，只能將你的 App 調起，並且把你需要的參數傳遞到你的 SplashActivity（Action 為 android.intent.action.MAIN 的 Activity） 上。

推送服務的 icon 和 字體顏色

FCM 的推送通知，可以配置 icon 以及 App 名稱的顏色。對 icon 和 字體顏色的配置，需要在 AndroidManifest.xml 中進行。

還有一點需要注意，通常我們 App 的 Icon 都做的非常的精美，但是這種 Icon 是無法直接使用在 FCM 的推送上的。需要額外的定制，以及對應的尺寸。

FCM Icon 的標准：背景透明，以白色圖案填充。（實際上，展開后的效果會將icon 進行着色，所以任何顏色最終都會被着色成我們配置的顏色，不配置默認是個淺灰色）。

當然，它和圖標的適配一樣，不一定需要全套，只需要配置我們需要的尺寸即可。

將以下代碼行添加到 application 標記內，以設置自定義默認圖標和app 名稱的自定義顏色：

<!-- Set custom default icon. This is used when no icon is set for incoming notification messages.
     See README(https://goo.gl/l4GJaQ) for more. -->

<meta-data
 android:name="com.google.firebase.messaging.default_notification_icon"
    android:resource="@drawable/ic_stat_ic_notification" />

<!-- Set color used with incoming notification messages. This is used when no color is set for the incoming
     notification message. See README(https://goo.gl/6BKBk7) for more. -->

<meta-data
 android:name="com.google.firebase.messaging.default_notification_color"
    android:resource="@color/colorAccent" />

AndroidManifest.xml

如果配置好這些，依然得到的是一個白色的小塊，可以嘗試升級一下 FCM 的版本，低版本好像是有這個 Bug ，在新版已經解決了。

 

問題:

• Firebase API initialization failure.
• Android app not receiving Firebase Notification when app is stopped from multi-task tray
• Push notification works incorrectly when app is on background or not running
• Push not received when app is killed

Firebase控制台測試只能發送Notification Message，測試的時候把App從最近列表划掉之后能收到，而且是在沒翻牆的情況下都能收到。當然當進程被完全殺死就收不到了。

Data Message則需要通過server api調用，前台后台都能收到透傳消息。

Android Push Notifications using Firebase Cloud Messaging FCM & PHP