极光推送在国内的App的覆盖率比较高,在第一时间就更新了对flutter的支持,使用极光简单配置后就可以进行远端推送和本地定时推送,非常方便。

image

推荐使用android进行测试,配置简单,ios需要证书,相对比较复杂。我也是用的安卓端进行演示。

注册极光

先到极光官网,注册账号,配置一下flutter项目的包名,如果不记得了,可以到flutter项目下的 android/app/build.gradle 中找一下,defaultConfig 下的 applicationId 就是包名,这个配置文件不要关,后续我们还会再回来。

image

image

在极光配置好安卓的包名后,我们会得到 AppKey,到这就算注册完成。

image

项目配置

继续打开,android/app/build.gradle 文件。

将 defaultConfig 中 minSdkVersion 修改为 17,flutter创建后默认是16,无法使用极光推送。

defaultConfig 中添加 manifestPlaceholders。

image

下面是我的配置,大家根据自己的情况修改即可:

defaultConfig {
applicationId "cn.idiocy66.fe_mp" // 包名
minSdkVersion 17 // 修改为17
targetSdkVersion 28
versionCode flutterVersionCode.toInteger()
versionName flutterVersionName
// 极光配置
manifestPlaceholders = [
JPUSH_PKGNAME : applicationId,
JPUSH_APPKEY : "9bf4f58ea9471001e0a4d66d", // 极光中的appkey
JPUSH_CHANNEL : "developer-default", // 默认即可.
]
}

初始化

配置完成,可以运行推送功能了。

使用极光推送功能前,必须先执行初始化函数:

final JPush jpush = new JPush();
jpush.setup(
appKey: "9bf4f58ea9471001e0a4d66d", // 极光中的appkey
channel: "theChannel",
production: false,
debug: true,
);

如果不进行初始化操作,在极光后台无法查询到对应的机器信息,也就无法使用推送功能。

获得唯一 rid

在同一个极光应用中,每个设备都拥有唯一的一个id,用于身份验证,后台也可以单独向这个rid进行消息推送。

使用getRegistrationID函数获取当前设备的rid:

jpush.getRegistrationID().then((rid) {
print("当前设备的rid: ${rid}");
});

本地推送

本地推送并不会收到极光的条数限制:

var localNotification = LocalNotification(
id: 234,
title: "本地推送",
buildId: 1,
content: "😁 随便写点内容,时间 ${DateTime.now().toIso8601String()}",
fireTime: DateTime.now(), // 立即发送
subtitle: "副标题 123456",
badge: 1,
extra: {"myInfo": "推送信息balabla"} // 携带数据
);
jpush.sendLocalNotification(localNotification);
image

本地定时推送

定时本地推送,传入DateTime,绝对时间。

// 3秒后进行本地推送
var fireDate = DateTime.fromMillisecondsSinceEpoch(DateTime.now().millisecondsSinceEpoch + 3000);
var localNotification = LocalNotification(
id: 1,
title: '定时推送',
buildId: 1,
content: '三秒后本地推送',
fireTime: fireDate,
subtitle: '子标题',
badge: 5,
extra: {"data": "附带数据"}
);
jpush.sendLocalNotification(localNotification);
image

远程推送

远程推送,我们暂时可以使用极光后台进行,当然有后台能力也可以直接使用api调用。

默认优先级的消息不会弹窗显示,需要调高优先级则可以在屏幕顶部弹出。

image

跳转系统推送设置

跳转到系统设置中的推送设置(当前应用),点击返回可以直接返回当前应用。

经常用于用户关闭推送后的再提醒。

jpush.openSettingsForNotification();
image

通常需要和权限获取相配合:

jpush.isNotificationEnabled().then((bool value) {
// 返回是否开启通知
});

当用户禁止通知时,提示跳转系统配置进行开启通知操作。

消息监听

推荐在 初始化函数 setup 前进行通知监控:

jpush.addEventHandler(
onReceiveNotification: (Map message) async {
print("接收到推送: $message");
},
onOpenNotification: (Map message) async {
print("通过点击推送进入app: $message");
},
onReceiveMessage: (Map message) async {
print("接收到自定义消息: $message");
},
onReceiveNotificationAuthorization: (Map message) async {
print("通知权限状态: $message");
}
);

推送和消息不同,推送是会显示在设备通知栏中,而消息不会。

消息是由后端api发送给设备上的,不会有任何提示,只能靠这里的监听来接收。

ios 推送是需要用户确认授权的,与安卓有差异,需要单独调用 applyPushAuthority 方法,弹出授权。如果用户不同意,后续无法再次弹出,只能跳转系统配置页面开启推送权限。

其他

推送的强大不仅如此,还有设置标签、设置别名等功能,可以将每个用户都进行精细划分,做到更精准的推送。