背景
MAUI的呈现,赋予了宽广Net开发者开发多平台利用的能力,MAUI 是Xamarin.Forms演变而来,然而相比Xamarin性能更好,可扩展性更强,构造更简略。然而MAUI对于平台相干的实现并不残缺。所以MASA团队发展了一个实验性我的项目,意在对微软MAUI的补充和扩大,我的项目地址https://github.com/BlazorComp…,每个性能都有独自的demo演示我的项目,思考到app安装文件体积(尽管MAUI曾经集成裁剪性能,然而该性能对于代码自身有影响),届时每一个性能都会以独自的nuget包的模式提供,不便测试,当初我的项目才刚刚开始,然而置信很快就会有能够交付的内容啦。
前言
本系列文章面向挪动开发小白,从零开始进行平台相干性能开发,演示如何参考平台的官网文档应用MAUI技术来开发相应性能。
介绍
上一篇文章咱们集成了个推的音讯告诉,那么音讯达到挪动端之后,除了会在告诉栏显示之外,在利用的角标也会显示未读音讯的数量(小红点),而后用户点击查看音讯之后,这些数字角标也能够主动打消,这个性能在MAUI中如何实现呢。
一、iOS局部
思路
https://developer.apple.com/d…
咱们参考一下官网文档,UIApplication下有一个applicationIconBadgeNumber的属性
var applicationIconBadgeNumber: Int { get set }
咱们只须要给这个属性赋值具体的整数即可,
https://developer.apple.com/d…
咱们能够通过shared获取以后UIApplication的实例,而后就能够给applicationIconBadgeNumber赋值了,然而如果你间接这样做,你会发现并没有成果,因为 iOS 8 当前,须要注册用户告诉,以取得用户的受权。
https://developer.apple.com/d…
咱们能够通过UNUserNotificationCenter的RequestAuthorization办法获取申请用户本地和近程的告诉权限。
开发步骤
咱们新建一个目录Badger,并在上面新建MAUI类库我的项目Masa.Blazor.Maui.Plugin.Badger,
在Platforms下的iOS文件夹新建MasaMauiBadgerService局部类
using UIKit;
using UserNotifications;
namespace Masa.Blazor.Maui.Plugin.Badger
{
public static partial class MasaMauiBadgerService
{
private static void PlatformSetNotificationCount(int count)
{
// Requests the user’s authorization to allow local and remote notifications for your app.
UNUserNotificationCenter.Current.RequestAuthorization(UNAuthorizationOptions.Badge, (r, e) =>{});
// The number currently set as the badge of the app icon on the Home screen
// Set to 0 (zero) to hide the badge number. The default value of this property is 0.
UIApplication.SharedApplication.ApplicationIconBadgeNumber = count;
}
}
}
RequestAuthorization办法有两个参数
1、UNAuthorizationOptions 代表利用申请的受权选项,这里咱们应用Badge
2、completionHandle 这是一个Action,有两个参数,第一个参数是一个bool值,代表是否已授予受权,第二个参数是一个NSError类型,示意蕴含错误信息或未产生谬误的对象。咱们这里暂不解决出错的状况
咱们通过UIApplication.SharedApplication获取以后的UIApplication实例,而后间接给
ApplicationIconBadgeNumber 赋值,这里如果咱们想革除角标,就间接赋值0即可。
咱们持续在我的项目根目录新建MasaMauiBadgerService类,通过SetNotificationCount来调用不同平台的PlatformSetNotificationCount办法。
namespace Masa.Blazor.Maui.Plugin.Badger
{
// All the code in this file is included in all platforms.
public static partial class MasaMauiBadgerService
{
public static void SetNotificationCount(int count)
{
PlatformSetNotificationCount(count);
}
}
}
二、安卓局部
思路
安卓局部比iOS绝对简单,咱们本着不造轮子的思维,找了一个现成的aar包,ShortcutBadger
我的项目maven地址:https://repo1.maven.org/maven…
开发步骤
1、咱们下载最新的ShortcutBadger-1.1.22.aar包,并新建Android Java 库绑定我的项目Masa.Blazor.Maui.Plugin.BadgerBinding
在根目录创立Jars文件夹,并将下载的aar文件增加进去。增加进去的文件属性中,生成操作默认抉择的是AndroidLibrary,如果不对请手动更正。
右键生成这个我的项目,这里很顺利没有任何报错。
2、咱们在Masa.Blazor.Maui.Plugin.Badger我的项目中援用Masa.Blazor.Maui.Plugin.BadgerBinding我的项目,因为咱们只有在安卓平台须要我的项目援用,所以咱们手动批改一下我的项目文件中的援用局部,增加Android平台的判断。
<ItemGroup Condition="'$(TargetFramework)' == 'net7.0-android'">
<ProjectReference Include="..\Masa.Blazor.Maui.Plugin.BadgerBinding\Masa.Blazor.Maui.Plugin.BadgerBinding.csproj" />
</ItemGroup>
3、从 Android 8.0(API 级别 26)开始,所有告诉都必须调配到相应的渠道,对于告诉通道的信息,能够参考以下官网文档
https://developer.android.goo…
Java 代码
private void createNotificationChannel() {
// Create the NotificationChannel, but only on API 26+ because
// the NotificationChannel class is new and not in the support library
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
CharSequence name = getString(R.string.channel_name);
String description = getString(R.string.channel_description);
int importance = NotificationManager.IMPORTANCE_DEFAULT;
NotificationChannel channel = new NotificationChannel(CHANNEL_ID, name, importance);
channel.setDescription(description);
// Register the channel with the system; you can't change the importance
// or other notification behaviors after this
NotificationManager notificationManager = getSystemService(NotificationManager.class);
notificationManager.createNotificationChannel(channel);
}
}
咱们参照以上写法,在Masa.Blazor.Maui.Plugin.Badger我的项目的Android平台目录下新建MasaMauiBadgerService 类,增加一个CreateNotificationChannel办法
using Android.App;
using AndroidX.Core.App;
namespace Masa.Blazor.Maui.Plugin.Badger
{
// All the code in this file is included in all platforms.
public static partial class MasaMauiBadgerService
{
private static void CreateNotificationChannel()
{
if (OperatingSystem.IsAndroidVersionAtLeast(26))
{
using var channel = new NotificationChannel($"{Android.App.Application.Context.PackageName}.channel", "Notification channel", NotificationImportance.Default)
{
Description = "Masa notification channel"
};
var notificationManager = NotificationManager.FromContext(Android.App.Application.Context);
notificationManager?.CreateNotificationChannel(channel);
}
}
}
}
1、通过OperatingSystem.IsAndroidVersionAtLeast来判断以后的Android版本。
2、NotificationChannel的创立形式与Java统一,三个参数别离为ChannelID,name、Importance
这里留神第三个参数代表重要性级别,咱们这里应用了NotificationImportance.Default。
用户可见的重要性级别 重要性(Android 8.0 及更高版本) 紧急:收回提示音,并以浮动告诉的模式显示 IMPORTANCE_HIG 高:收回提示音 IMPORTANCE_DEFAULT 中:无提示音 IMPORTANCE_LOW 低:无提示音,且不会在状态栏中显示 IMPORTANCE_MIN 3、Description 指定用户在零碎设置中看到的阐明。
4、通过NotificationManager.FromContext 创立 notificationManager,而后调用CreateNotificationChannel来创立告诉通道。
咱们持续增加SetNotificationCount办法
private static void PlatformSetNotificationCount(int count)
{
ME.Leolin.Shortcutbadger.ShortcutBadger.ApplyCount(Android.App.Application.Context, count);
NotificationCompat.Builder builder = new(Android.App.Application.Context, $"{Android.App.Application.Context.PackageName}.channel");
builder.SetNumber(count);
builder.SetContentTitle(" ");
builder.SetContentText("");
builder.SetSmallIcon(Android.Resource.Drawable.SymDefAppIcon);
var notification = builder.Build();
var notificationManager = NotificationManager.FromContext(Android.App.Application.Context);
CreateNotificationChannel();
notificationManager?.Notify((int)DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(), notification);
}
1、调用ShortcutBadger的ApplyCount办法来增加角标
2、创立NotificationCompat.Builder示例,并以此设置角标显示数量(SetNumber),告诉的题目(SetContentTitle)和内容(SetContentText),以及告诉图标(SetSmallIcon)。
3、调用咱们刚写好的办法创立告诉通道。
4、通过NotificationManager.Notify办法在状态栏公布一条告诉。
该办法有两个参数,第一个参数是一个int类型id,这个id是告诉的标识符,在应用程序中应该惟一。这里须要留神:如果你公布了雷同id的告诉,并且前一个并没有勾销,那么该id对应的告诉会被更新。第二个参数是一个notification 对象,是通过NotificationCompat.Builder创立进去的。
三、创立Demo我的项目
1、新建一个MAUI Blazor我的项目:BadgerSample,增加对Masa.Blazor.Maui.Plugin.Badger我的项目的援用
2、增加Android权限:批改Android平台目录中的AndroidManifest.xml文件,增加必要的权限。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application android:allowBackup="true" android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" android:supportsRtl="true"></application>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
<uses-permission android:name="android.permission.READ_APP_BADGE" />
<uses-permission android:name="com.android.launcher.permission.READ_SETTINGS"/>
<uses-permission android:name="com.android.launcher.permission.WRITE_SETTINGS"/>
<uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" />
<uses-permission android:name="com.android.launcher.permission.UNINSTALL_SHORTCUT" />
</manifest>
留神:国内不同手机厂家可能须要额定的权限配置,须要参考具体厂家的配置阐明。
3、批改Index.razor文件
理论的应用场景应该是挪动端接管音讯推送,在解决音讯推送的办法内批改角标,咱们这里为了简化,在页面间接通过按钮触发批改角标显示的数量。
@page "/"
@using Masa.Blazor.Maui.Plugin.Badger;
<h1>Masa blazor badger sample</h1>
Masa blazor badger sample.
<button @onclick="OnIncrementClicked">Add</button>
<button @onclick="OnClearClicked">Clear</button>
@code{
int count;
private void OnIncrementClicked()
{
count++;
MasaMauiBadgerService.SetNotificationCount(count);
}
private void OnClearClicked()
{
count = 0;
MasaMauiBadgerService.SetNotificationCount(count);
}
}
Android 演示:演示机:vivo x70 pro+
iOS 演示:演示机:iPhone 14 iOS16 模拟器
如果你对咱们的 MASA Framework 感兴趣,无论是代码奉献、应用、提 Issue,欢送分割咱们
WeChat:MasaStackTechOps
QQ:7424099
发表回复