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 牵涉到墙的问题，需要手机能够*， 否则测试将不能成功，另外，在做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/添加一个项目 如图：

这里我创建一个项目叫：XamarinAndroidFCM。创建好后像下面这样：

这一步暂时就创建到这里，我们需要一个android app的Package 名称， 下面我们将创建一个android项目创建好以后再回来设置这个包的名称。

在Azure上创建一个NotificationHub

登录到Azure 在云端在左边的菜单中找到NotificationHub项， 点击想创建一个Notification Hub Namespaces， 然后进入NameSpace并且创建一个NotificaitonHub。

然后点击创建的NotificaitonHub名字进入设置界面，并且点击中间的菜单GCM（google），设置这个API key

这个key 来自上一步创建的Firebase 项目：

这样FCM 和Notifaction Hub就关联好了。

创建一个Xiamarin android APP 并关联上 NotificationHub和 Firebase Cloud Message

打开VS 创建一个xiamarin for Android的项目。创建好后如下：

打开项目将的配置文件：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中去 并保存。

保存完成后点击右边的google-service.json 文件下载到本地并加入到创建的android项目中

这样FCM的相关设置就完了。

在android的项目中做FCM 以及Azure NotificationHub的连接并接收消息

1. 添加相关的依赖包： Xamarin.Firebase.Messaging 和 Xamarin.Azure.NotificationHubs.Android

2. 设置google-service.json 的build action 为“GoogleServicesJson”（如果找不到这一项，重启一下VS重新设置就可以找到了）

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>

如下：

4. 配置Notification Hub 账号到代码中。

在项目中创建一个Class 叫：Constants， 并创建两个常量用于保存NotificaiotnHub的连接字符串和名称。打开azrue中创建的Hub 点击左边的Access Policy，看到如下界面：

将DefaultListenSharedAccessSignature的Connection String值拷贝到刚刚创建的那个常量 ListenConnectionString 中。并把Notificaiton Hub的名字保存在

NotificationHubName中。

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>() { "" };
            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 进入到测试界面进行测试：

手机端接收到的消息如下：

总结，Notificaiton Hub + FCM发送消息比较简单，但是也有许多坑，设置比较多，比如应用包的大小写问题，*的问题都是一些小的阻碍，但是这个消息推送还是比较稳定的， 适合一些国外的项目。 如果做国内的项目可以考虑Notification Hub+ 百度message来做消息推送，当然也可以用一些第三方的SDK来做。

源码下载地址： https://github.com/Xushlin/PushNotificaiton