1. 程式人生 > >Windows Azure NotificationHub+Firebase Cloud Message 實現訊息推動(付原始碼)

Windows Azure NotificationHub+Firebase Cloud Message 實現訊息推動(付原始碼)

前期專案一直用的是Windows azure NotificationHub+Google Cloud Message 實現訊息推送, 但是GCM google已經不再推薦使用,慢慢就不再維護了, 現在Google 主推 FCM, 另一方面,google在android生態中的許可權要求越來越嚴格,不像以前那樣將許可權宣告在AndroidManifest中,在安裝的時候做一次提醒就好了, 現在對於一些主要的許可權需要動態申請並且使用者同意才能使用,比如呼叫相機,使用電話本等等,同樣對於後臺的常駐服務也做了一定的限制,旨在提升android系統的使用者體驗以及提高電池的續航時間,在2018-11-1強制執行編譯的Target SDK API Leve必須是26+,否則是不允許上Goolge Play , GCM也只支援到2019-11-1,之後就不再支援,專案老的推送服務要依賴於後臺常駐Service。 基於以上原因我對當前的android專案做了一次全面升級。這裡分享一下GCM到FCM的遷移過程。

我們的專案用的微軟的Azure平臺,自然所有的一切技術都圍繞著Windows Azure 平臺展開。 Web App, Web API 使用的是Azure Cloud Service, Mobile APP 使用的是Xamarin, 資料庫使用的是Azure SQL Database, 是不是很微軟系。

自然在訊息推送的時候想到的還是Azure平臺上的技術 Notification Hub。

名詞解釋:

GCM: Google Cloud Message.

FCM: Firebase Cloud Message.

遷移步驟

1. 建立一個Firebase 專案並且開啟Firebase Cloud Messaging功能。

2. 在Azure上建立一個NotificationHub。

3.將Firebase和ConnectionHub關聯上。

4.建立一個Xiamarin android APP 並關聯上 NotificationHub和 Firebase Cloud Message。

5. 測試訊息傳送。

注意:由於需要連線到Firebase Cloud Message 牽涉到牆的問題,需要手機能夠FQ, 否則測試將不能成功,另外,在做FCM的設定也是寸步難行。

準備工作

1. 需要一個google賬號,用於建立Firebase 專案並開啟 Firebase Cloud Message。

2.需要一個azure賬號,用於建立NotificationHub。

3.Visual Studio 並且要安裝Xamarin 外掛。

4. 準備一個VPN 用於測試。

建立一個Firebase 專案並且開啟Firebase Cloud Messaging功能

開啟 Firebase 開發控制檯https://console.firebase.google.com/新增一個專案 如圖:

image

 

這裡我建立一個專案叫:XamarinAndroidFCM。建立好後像下面這樣:

image

這一步暫時就建立到這裡,我們需要一個android app的Package 名稱, 下面我們將建立一個android專案建立好以後再回來設定這個包的名稱。

在Azure上建立一個NotificationHub

登入到Azure 在雲端在左邊的選單中找到NotificationHub項, 點選想建立一個Notification Hub Namespaces, 然後進入NameSpace並且建立一個NotificaitonHub。

image

然後點選建立的NotificaitonHub名字進入設定介面,並且點選中間的選單GCM(google),設定這個API key

image

這個key 來自上一步建立的Firebase 專案:

image

這樣FCM 和Notifaction Hub就關聯好了。

建立一個Xiamarin android APP 並關聯上 NotificationHub和 Firebase Cloud Message

開啟VS 建立一個xiamarin for Android的專案。建立好後如下:

image

開啟專案將的配置檔案:AndroidManifest.xml, 將裡面的包名改成小寫(這裡很重要,如果不改成小寫,你將不會收到任何訊息,這是個坑,做GCM的時候也是一樣, 測試了很多次才找出來這個原因

<manifest xmlns:android="http://schemas.android.com/apk/res/android" android:versionCode="1" 
          android:versionName="1.0" package="xamarinandroidfcm.xamarinandroidfcm">

這裡我們將這個包名“xamarinandroidfcm.xamarinandroidfcm” 填到第一步FCM中去 並儲存。

image

儲存完成後點選右邊的google-service.json 檔案下載到本地並加入到建立的android專案中

image

這樣FCM的相關設定就完了。

在android的專案中做FCM 以及Azure NotificationHub的連線並接收訊息

1. 新增相關的依賴包: Xamarin.Firebase.Messaging 和 Xamarin.Azure.NotificationHubs.Android

image

 

image

 

2. 設定google-service.json 的build action 為“GoogleServicesJson”(如果找不到這一項,重啟一下VS重新設定就可以找到了

image

3. 在AndroidManifest.xmal 的Application節點中加入以下配置:

<receiver android:name="com.google.firebase.iid.FirebaseInstanceIdInternalReceiver" android:exported="false" />
		<receiver android:name="com.google.firebase.iid.FirebaseInstanceIdReceiver" android:exported="true" 
		          android:permission="com.google.android.c2dm.permission.SEND">
			<intent-filter>
				<action android:name="com.google.android.c2dm.intent.RECEIVE" />
				<action android:name="com.google.android.c2dm.intent.REGISTRATION" />
				<category android:name="${applicationId}" />
			</intent-filter>
		</receiver>

如下:

image

4. 配置Notification Hub 賬號到程式碼中。

在專案中建立一個Class 叫:Constants, 並建立兩個常量用於儲存NotificaiotnHub的連線字串和名稱。開啟azrue中建立的Hub 點選左邊的Access Policy,看到如下介面:

image

將DefaultListenSharedAccessSignature的Connection String值拷貝到剛剛建立的那個常量 ListenConnectionString 中。並把Notificaiton Hub的名字儲存在

NotificationHubName中。

 

image

5.建立MyFirebaseIidService 服務類用於接收和重新整理Firebase的token, 並將token以及tag註冊到Notificationhub.

using System.Collections.Generic;
using Android.App;
using Android.Util;
using WindowsAzure.Messaging;
using Firebase.Iid;

namespace XamarinAndroidFCM
{
    [Service]
    [IntentFilter(new[] {"com.google.firebase.INSTANCE_ID_EVENT"})]
    public class MyFirebaseIidService : FirebaseInstanceIdService
    {
        private const string Tag = "MyFirebaseIIDService";
        NotificationHub _hub;

        public override void OnTokenRefresh()
        {
            var refreshedToken = FirebaseInstanceId.Instance.Token;
            Log.Debug(Tag, "FCM token: " + refreshedToken);
            SendRegistrationToServer(refreshedToken);
        }

        void SendRegistrationToServer(string token)
        {
            // Register with Notification Hubs
            _hub = new NotificationHub(Constants.NotificationHubName,Constants.ListenConnectionString, this);

            var tags = new List<string>() { "1" };
            var regID = _hub.Register(token, tags.ToArray()).RegistrationId;
            Log.Debug(Tag, $"Successful registration of ID {regID}");
        }
    }
}

6. 建立接收訊息的服務:MyFirebaseMessagingService 用於接收訊息並顯示給使用者:

using System;
using System.Linq;
using Android.App;
using Android.Content;
using Android.Util;
using Android.Widget;
using Firebase.Messaging;

namespace XamarinAndroidFCM
{
    [Service]
    [IntentFilter(new[] {"com.google.firebase.MESSAGING_EVENT"})]
    public class MyFirebaseMessagingService : FirebaseMessagingService
    {
        private const string Tag = "MyFirebaseMsgService";
        public override void OnMessageReceived(RemoteMessage message)
        {
            Log.Debug(Tag, "From: " + message.From);
            if (message.GetNotification() != null)
            {
                //These is how most messages will be received
                Log.Debug(Tag, "Notification Message Body: " + message.GetNotification().Body);
                SendNotification(message.GetNotification().Body);
            }
            else
            {
                //Only used for debugging payloads sent from the Azure portal
                CreateNotification("Test FCM", message.Data.Values.First(), "15:30");
            }
        }

        void SendNotification(string messageBody)
        {
            var intent = new Intent(this, typeof(MainActivity));
            intent.AddFlags(ActivityFlags.ClearTop);
            var pendingIntent = PendingIntent.GetActivity(this, 0, intent, PendingIntentFlags.OneShot);

            var notificationBuilder = new Notification.Builder(this)
                .SetContentTitle("FCM Message")
                .SetSmallIcon(Resource.Drawable.ic_launcher)
                .SetContentText(messageBody)
                .SetAutoCancel(true)
                .SetContentIntent(pendingIntent);

            var notificationManager = NotificationManager.FromContext(this);
            notificationManager.Notify(0, notificationBuilder.Build());
        }

        void CreateNotification(string title, string desc, string time)
        {
            var notificationManager = GetSystemService(Context.NotificationService) as NotificationManager;
            var uiIntent = new Intent(this, typeof(MainActivity));
            var notification = new Notification(Resource.Mipmap.ic_launcher, title);
            notification.Flags = NotificationFlags.AutoCancel;
            notification.Defaults = NotificationDefaults.All;
            notification.Vibrate = new long[] { 0, 100, 200, 300 };
            if (Android.OS.Build.VERSION.SdkInt >= Android.OS.BuildVersionCodes.JellyBean)
            {
                var contentView = new RemoteViews(PackageName, Resource.Layout.Custom_Notification);
                contentView.SetTextViewText(Resource.Id.txtTitle, title);
                contentView.SetTextViewText(Resource.Id.txtTime, time);
                contentView.SetTextViewText(Resource.Id.txtContent, desc);
                notification.BigContentView = contentView;
            }
            notification.SetLatestEventInfo(this, title, desc, PendingIntent.GetActivity(this, 0, uiIntent, PendingIntentFlags.UpdateCurrent));

            var rnd = new Random();
            var notificationId = rnd.Next(10000, 99999);

            notificationManager.Notify(notificationId, notification);
        }
    }
}

 

程式碼部分全部實現完成。

測試

開啟模擬器或手機,設定代理, 除錯應用, 並且再次開啟Azure Notifiaciton Hub 進入到測試介面進行測試:

image

 

手機端接收到的訊息如下:

image

 

總結,Notificaiton Hub + FCM傳送訊息比較簡單,但是也有許多坑,設定比較多,比如應用包的大小寫問題,FQ的問題都是一些小的阻礙,但是這個訊息推送還是比較穩定的, 適合一些國外的專案。 如果做國內的專案可以考慮Notification Hub+ 百度message來做訊息推送,當然也可以原則一些第三方的SDK來做。

原始碼下載地址: https://github.com/Xushlin/PushNotificaiton