MASA MAUI Plugin (十)iOS消息推送(原生APNS方式)
背景
MAUI的出现,赋予了广大.Net开发者开发多平台应用的能力,MAUI 是Xamarin.Forms演变而来,但是相比Xamarin性能更好,可扩展性更强,结构更简单。但是MAUI对于平台相关的实现并不完整。所以MASA团队开展了一个实验性项目,意在对微软MAUI的补充和扩展
项目地址http://github.com/BlazorComponent/MASA.Blazor/tree/feature/Maui/src/Masa.Blazor.Maui.Plugin
每个功能都有单独的demo演示项目,考虑到app安装文件体积(虽然MAUI已经集成裁剪功能,但是该功能对于代码本身有影响),届时每一个功能都会以单独的nuget包的形式提供,方便测试,现在项目才刚刚开始,但是相信很快就会有可以交付的内容啦。
前言
本系列文章面向移动开发小白,从零开始进行平台相关功能开发,演示如何参考平台的官方文档使用MAUI技术来开发相应功能。
介绍
Apple 推送通知服务(Apple Push Notification service),简称 APNs。与之前Android使用个推不同,由于APNs国内可用,所以我们可以直接使用APNs来实现远程消息推送,不依赖其他第三方组件和服务。我们这里推送使用的是p8证书,p8证书相对p12证书来讲,更灵活,而且没有p12证书有效期1年的限制。
一、实现方式
一、申请p8证书
1、登录开发者中心,点击右上角Account,找到Keys管理。
2、在顶部点击+号。
3、勾选APNs服务,并输入Key名称,下一步Continue。
4、点击Register。
5、记录Key ID,并下载证书,得到AuthKey_xxxxxxxxxx.p8证书文件。
6、获取Team ID,Account界面点击Membership details
二、编写MAUI实现代码
参考官方文档:http://developer.apple.com/documentation/usernotifications/registering_your_app_with_apns
1、首先需要先开启App消息推送的能力
我们新建一个iOSPush 文件夹,并在文件夹下面新建MauiBlazor项目iOSPushSample (由于受打包长度影响,项目名称和文件夹名称,我这里尽量简短。路径长度超过255会导致编译时提示部分文件找不到。) 我们找到Platforms->iOS->Info.plist文件,双击用默认的iOS清单编辑器打开,勾选“启用后台模式”和“远程通知”。这项操作会在Info.plist文件中添加如下信息:
<key>UIBackgroundModes</key>
<array>
<string>remote-notification</string>
</array>
在开发环境,你需要以下的额外配置。
如果你的项目已经使用了Entitlements.plist文件,双击打开改文件,并勾选“推送通知”。 如果没有这个文件,那么新建这个文本文件,内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>aps-environment</key>
<string>development</string>
</dict>
</plist>
注意:这项配置的目的是在development环境支持推送,如果在项目发布的时候,MAUI不会自动清除,需要手动关闭或注释掉这项配置,否则会报错。
2、编写实现代码
参考文档 http://developer.apple.com/documentation/usernotifications/registering_your_app_with_apns
我们首先需要将App注册到APNs并获取唯一的device token。在iOS中需要调用UIApplication 中通过registerForRemoteNotifications() 方法,实现注册,如果注册成功,就可以在delegate的application(_:didRegisterForRemoteNotificationsWithDeviceToken:) 方法中获取device token。如果注册失败,会触发application(_:didFailToRegisterForRemoteNotificationsWithError:) 方法。
Swift代码
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions:
[UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// Override point for customization after application launch.you’re
UIApplication.shared.registerForRemoteNotifications()
return true
}
func application(_ application: UIApplication,
didRegisterForRemoteNotificationsWithDeviceToken
deviceToken: Data) {
self.sendDeviceTokenToServer(data: deviceToken)
}
func application(_ application: UIApplication,
didFailToRegisterForRemoteNotificationsWithError
error: Error) {
// Try again later.
}
我们开始编写代码
向APNs注册设备
首先在iOS->AppDelegate.cs 类中,重写FinishedLaunching 方法,在应用启动之后进行注册。
[Register("AppDelegate")]
public class AppDelegate : MauiUIApplicationDelegate
{
protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
{
UNUserNotificationCenter center = UNUserNotificationCenter.Current;
var options = UNAuthorizationOptions.Alert | UNAuthorizationOptions.Sound | UNAuthorizationOptions.CriticalAlert;
// Request notification permissions from the user
center.RequestAuthorization(options,
(bool success, NSError error) =>
{
// Handle approval
}
);
UIApplication.SharedApplication.RegisterForRemoteNotifications();
return base.FinishedLaunching(application, launchOptions);
}
}
应用启动时应立即请求通知权限,方法是将以下代码添加到FinishedLaunchingAppDelegate 所需通知类型 (UNAuthorizationOptions) 的方法:
UNUserNotificationCenter 仅适用于 iOS 10+,但是考虑到基本没人用低于10的版本了,这里我们就不做版本检查了
用户可以批准应用的三个不同级别的通知请求: 横幅显示-Alert 。 声音警报-Sound 。 对应用图标进行错误设置-CriticalAlert。
请求权限结束后我们通过 UIApplication.SharedApplication.RegisterForRemoteNotifications(); 向APNs注册。 注册成功后我们通过application:didRegisterForRemoteNotificationsWithDeviceToken: 方法获取device token,但是由于这个方法是在UIApplication下,但是我们的AppDelegate是继承自 MauiUIApplicationDelegate ,默认没有这个方法,我们可以通过Export特性,导出我们需要的方法,继续在AppDelegate中添加
[Export("application:didFailToRegisterForRemoteNotificationsWithError:")]
public void FailedToRegisterForRemoteNotifications(UIKit.UIApplication application, NSError error)
{
Console.WriteLine("FailedToRegisterForRemoteNotifications");
}
[Export("application:didRegisterForRemoteNotificationsWithDeviceToken:")]
public void RegisteredForRemoteNotifications(UIKit.UIApplication application,
Foundation.NSData deviceToken)
{
var token = ExtractToken(deviceToken);
Preferences.Default.Set("PushToken", token);
Console.WriteLine(token);
}
private string ExtractToken(NSData deviceToken)
{
if (deviceToken.Length == 0)
return null;
var result = new byte[deviceToken.Length];
System.Runtime.InteropServices.Marshal.Copy(deviceToken.Bytes, result, 0, (int)deviceToken.Length);
return BitConverter.ToString(result).Replace("-", "");
}
ExtractToken是将返回的deviceToken解析为推送可用的字符串。 我们通过Preferences.Default.Set将token存储起来,方便在登录等业务中使用。
接收远程推送
接收推送的消息是通过**application:didReceiveRemoteNotification:fetchCompletionHandler:**实现的
[Export("application:didReceiveRemoteNotification:fetchCompletionHandler:")]
public void DidReceiveRemoteNotification(UIKit.UIApplication application, NSDictionary userInfo, Action<UIKit.UIBackgroundFetchResult> completionHandler)
{
foreach (var item in userInfo)
{
var alertMsg = ((NSDictionary)item.Value)["alert"];
Console.WriteLine($"alertMsg:{alertMsg}");
}
Console.WriteLine("DidReceiveRemoteNotification");
}
其实我们在方法内部不需要写任何代码,就可以实现基本的推送功能。但如果想处理推送过来的消息,可以通过NSDictionary类型userInfo中拿到。这里示例从alert中拿到具体的消息内容,并打印。
三、编写演示代码
我们修改Index.razor,通过点击按钮获取设备Token
@page "/"
<button @onclick="GetDeviceToken">Get Device Token</button>
<text>@deviceToken</text>
@code
{
private string deviceToken { get; set; }
private void GetDeviceToken()
{
deviceToken= Preferences.Default.Get("PushToken",string.Empty);
}
}
四、服务端测试
我们可以通过个推的在线测试工具,配置好p8证书和其他参数。 我这里写了一个命令行的测试程序,这里使用了第三方的PushNotifications.Server包
using PushNotifications.Server.Apple;
Console.WriteLine("Hello, World!");
IApnsClient apnsClient = new ApnsClient(new ApnsJwtOptions
{
CertContent = "-----BEGIN PRIVATE KEY-----\r\nxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\r\n-----END PRIVATE KEY-----",
KeyId = "LUxxxxxxxx",
TeamId = "V4xxxxxxxx",
BundleId = "com.iOSPush.Sample",
UseSandbox = true
});
var apnsRequest = new ApnsRequest(ApplePushType.Alert)
.AddToken("47006118F8xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
.AddSound()
.AddAlert("MASA", $"Message @ {DateTime.Now}", $"Message @ {DateTime.Now}");
var apnsResponse = await apnsClient.SendAsync(apnsRequest);
Console.ReadKey();
五、演示效果
可以看出,应用打开的状态不会收到推送,后台运行或者划掉关闭都可以收到通知。
如果你对我们的 MASA Framework 感兴趣,无论是代码贡献、使用、提 Issue,欢迎联系我们
- Blazor在IoT领域的前端实践 @.NET开发者日
- MASA MAUI Plugin (十)iOS消息推送(原生APNS方式)
- MASA MAUI Plugin (九)Android相册多选照片(使用Android Jetpack套件库)
- MASA MAUI Plugin (八)Android相册多选照片(Intent 方式)
- MASA Stack 1.0 发布会讲稿——生态篇
- MASA Stack 1.0 发布会讲稿——实践篇
- MASA Stack 1.0 发布会讲稿——产品篇
- MASA Stack 1.0 发布会讲稿——趋势篇
- MASA MAUI Plugin (七)应用通知角标(小红点)Android iOS
- .NET现代化应用开发 - CQRS&类目管理代码剖析
- MASA MAUI Plugin 安卓蓝牙低功耗(二)蓝牙通讯
- MASA MAUI Plugin 安卓蓝牙低功耗(一)蓝牙扫描
- MASA MAUI Plugin 安卓蓝牙低功耗(二)蓝牙通讯
- MASA MAUI Plugin 安卓蓝牙低功耗(一)蓝牙扫描
- MASA Framework的分布式锁设计
- MAUI Masa Blazor 开发界面跟随系统主题切换的App
- MAUI Masa Blazor 开发界面跟随系统主题切换的App
- MAUI Masa Blazor 开发带自动更新功能的安卓App
- 开篇-开启全新的.NET现代应用开发体验
- 怎么样的框架对于开发者是友好的?