Xamarin.Android实现通知推送功能（1）

1、背景说明

在App开发中，通知（或消息）的推送，是必须要有的功能。若在纯互联网的环境中，可以使用第三方的通知推送的功能，例如：小米推送、极光推送等，这个可以参考第三方的使用手册既可。但是在局域网中，例如医院内部的局域网中，则无法使用第三方的通知推送。因此在局域网环境中实现App通知推送的功能，就非常重要和关键。

本文将分为上下两部分。第一部分主要阐述Xamarin.Android的通知推送的功能实现。第二部分阐述如何在局域网环境下实现推送，并借助第一部分消息推送，从而实现整体的通知推送。

1.1 开发环境

使用VS2022社区版17.10.1，其中Xamarin为17.10.0.110

1.2 实现效果

Xamarin.Android中实现通知推送与Android基本一致。实现的效果如下：

图1 为主界面，点击右下角信封按钮，则系统会进行消息推送（主界面为：MainActivity）

图2 系统收到推送后，在状态栏中弹出的推送内容

图3 当点击状态栏中的推送消息时，跳转到该推送的详细说明页面（即后续的NotificationDetailInfoActivity）

图4 当在推送详细页面（NotificationDetailInfoActivity）点击返回按钮后，App返回至第二个Activity（即：SecondActivity）

图5 在图4的界面上（即SecondActivity），点击返回按钮后，App返回至主界面（即MainActivity）

1.2.1 推送的界面

在整个工程中，涉及到3个Activity：MainActivity、SecondActivity、NotificationDetailInfoActivity。如下图6所示

图6 工程涉及到的三个Activity

1.2.2 推送的设置

因为推送是在Activity中发生，所以需要再Activity的OnCreate方法中初始化通知设置（NotificationChannel）

private string CHANNEL_ID = "20000";
protected override void OnCreate(Bundle savedInstanceState)
{
    base.OnCreate(savedInstanceState);
    //初始化一个Channel
    CreateNotificationChannel();
}


void CreateNotificationChannel()
{
    if (Build.VERSION.SdkInt < BuildVersionCodes.O)
    {
        // Notification channels are new in API 26 (and not a part of the
        // support library). There is no need to create a notification
        // channel on older versions of Android.
        return;
    }

    var channelName = Resources.GetString(Resource.String.second_channel_name);
    var channelDescription = GetString(Resource.String.second_channel_description);
    var channel = new NotificationChannel(CHANNEL_ID, channelName, NotificationImportance.Default)
    {
        Description = channelDescription
    };

    var notificationManager = (NotificationManager)GetSystemService(NotificationService);
    notificationManager.CreateNotificationChannel(channel);
}

其中会涉及到Channel的名称和描述。也就是Resource.String.second_channel_name和Resource.String.second_channel_description。这部分信息在Strings.xml中。具体如下：

<resources>
    <string name="app_name">通知推送Demo</string>
    <string name="action_settings">Settings</string>

	<string name="channel_name">推送测试的名称</string>
	<string name="channel_description">用于说明本推送的具体内容</string>

	<string name="second_channel_name">第二个推送的名称</string>
	<string name="second_channel_description">第二个用于说明推送的说明性文字（例如：本推送用于推送患者的用药服用信息！）</string>
</resources>

在MainActivity、SecondActivity中的OnCreate方法中都应用，因此效果如下

图7 在MainActivity、SecondActivity设置通知后，可以在手机的通知界面看到这两个推送的设置

图8 这个是MainActivity中推送设置

图8 这个是SecondActivity中推送设置详细信息界面，可以看到标题和提示的内容

1.2.3 推送的功能实现

1.2.3.1、Activity的设置【重要】

若要设置返回时，按指定的顺序返回，则必须要设置Activity的ParentActivity属性。在Android原生开发中，是在AndroidManifest.xml进行设置的。设置一般是这样子的：

<activity android:name=".MessageActivity"  android:parentActivityName=".MainActivity"/>

但是，在Xamarin.Android中，没法在AndroidManifest.xml设置，需要在Activity.cs中定义。

//在这儿设置******【重要】
[Activity(Label = "SecondActivity", ParentActivity = typeof(MainActivity))]
public class SecondActivity : Activity
{
    private TextView tvTitle;
    private string CHANNEL_ID = "20000";
    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        // Create your application here
        CreateNotificationChannel();//设置推送的通知
    }
    ....

这个地方是最特殊的地方，一定要注意。
在本项目中，将NotificationDetailInfoActivity的ParentActivity设为SecondActivity；而SecondActivity的ParentActivity设置为MainActivity。

1.2.3.2、代码的实现

以上设置完成后，便可以在按钮的click方法中，实现消息的推送及实现，代码如下：

private void FabOnClick(object sender, EventArgs eventArgs)
{
    //View view = (View) sender;
    //Snackbar.Make(view, "Replace with your own action", Snackbar.LengthLong)
    //    .SetAction("Action", (View.IOnClickListener)null).Show();

    //第二步，在某个地方触发这个通知（此处是点击按钮）
    //点击推送通知后，要调用起来的Activity
    Intent intent = new Intent(this, typeof(NotificationDetailInfoActivity));
    //传递的数据。也可以使用Bundle，可以搜索Bundle传值
    intent.PutExtra("message", "附加的详细信息，用于展示提示的具体内容！");

    //创建TaskStackBuilder，用于形成任务链，就是点击通知后，后续的返回界面等设置
    Android.App.TaskStackBuilder stackBuilder = Android.App.TaskStackBuilder.Create(this);

    //1、在Activity中设置ParentActivity属性。在Android的原生开发中，是在Manifest中设置，
    //但是在Xamarin中，需要直接在Activity中设置
    //2、直接调用AddNextIntentWithParentStack方法既可
    stackBuilder.AddNextIntentWithParentStack(intent);


    //网络上的设置，但在Xamarin中没有作用
    //stackBuilder.AddParentStack(Java.Lang.Class.FromType(typeof(MainActivity)));
    //stackBuilder.AddParentStack(Java.Lang.Class.FromType(typeof(SecondActivity)));
    //stackBuilder.AddNextIntent(intent);

    //设置PendingIntent
    const int pendingIntentId = 0;
    PendingIntent pendingIntent =stackBuilder.GetPendingIntent(pendingIntentId, PendingIntentFlags.UpdateCurrent);


    NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .SetContentIntent(pendingIntent)
        .SetContentTitle("推送的标题内容") //1
        .SetContentText("推送的具体内容信息") //2
        .SetAutoCancel(true)  //设置自动取消
        .SetWhen(Java.Lang.JavaSystem.CurrentTimeMillis())
        .SetSmallIcon(Resource.Drawable.zl001);


    
    //调用通知
    Notification notification = builder.Build();

    NotificationManager notificationManager = GetSystemService(Context.NotificationService) as NotificationManager;

    const int notificationId = 1;
    notificationManager.Notify(notificationId, notification);
}

代码说明：
1、网上查找的资料（设置微软的官网上），在设置返回时，是如下面代码设置的。

//stackBuilder.AddParentStack(Java.Lang.Class.FromType(typeof(MainActivity)));
//stackBuilder.AddParentStack(Java.Lang.Class.FromType(typeof(SecondActivity)));
//stackBuilder.AddNextIntent(intent);

但在实际使用中，确是不起作用。在NotificationDetailInfoActivity界面，点击返回时，会返回至MainActivity，而不是按照指定的顺序进行。

因此直接使用了stackBuilder.AddNextIntentWithParentStack(intent);这句话。按自身的Stack顺序，进行返回。

2、PendingIntentFlags.UpdateCurrent标识位
这个标识位有很多，比较简单，使用比较多就是UpdateCurrent，大家可以自行查看资料

2、源码下载

源码已上传，正在审核中。若审核通过，将添加正式的连接地址

3、总结

第一部分主要讲述推送基本设置，推送设置中还有一些样式的设置，大家可以到官网上进行学习。
下一部分将讲述在局域网内实时实现消息的推送

4、参考资料

主要查看了官网微软官网和这篇博文。