先奉上Demo地址
话不多说,直接开干。
第一步:注册、登陆JPush官网并创建应用
-
注册登陆JPush官网
-
添加一个项目,输入项目名称并设置图标。
创建应用 -
然后进行推送设置,设置Android的包名以及iOS的证书。
-
Android 报名设置。
Android推送设置 -
iOS配置。
-
用Xcode打开我们的项目,或者项目目录中找到 ios-> Runner.xcodeproj 然后双击Runner.xcodeproj运行。
用Xcode打开项目
-
-
在Runner中设置 Bundle Identifier的值为正确的包名。
配置包名
-
为了防止在编译时会自动变更,所以最好将info.plist中的配置也修改一下。
配置包名
-
证书配置。
由于我没有苹果开发者的账号,所以这一步我无法操作。有兴趣的可以参考JPush官方提供的文档。
第二步:启动你的Flutter项目集成极光推送。
-
安装jpush_flutter插件
在你项目的pubspec.yaml文件中的
dependencies
节点下添加以下代码dependencies: flutter: sdk: flutter jpush_flutter: 0.6.0 #极光推送插件
-
Android配置
在
/android/app/build.gradle
中添加下列代码:android: { .... defaultConfig { applicationId "替换成自己应用 ID" ... ndk { //选择要添加的对应 cpu 类型的 .so 库。 abiFilters 'armeabi', 'armeabi-v7a', 'x86', 'x86_64', 'mips', 'mips64', 'arm64-v8a' } manifestPlaceholders = [ JPUSH_PKGNAME : applicationId, JPUSH_APPKEY : "appkey", // NOTE: JPush 上注册的包名对应的 Appkey. JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可. ] } }
-
iOS配置
在 xcode8 之后需要点开推送选项: TARGETS -> Capabilities -> Push Notification 设为 on 状态。
开启 Push Notification 开启后
第三步:初始化jpush_flutter插件。
-
调用setup方法初始化JPush
添加初始化方法,调用 setup 方法会执行两个操作:
- 初始化 JPush SDK
- 将缓存的事件下发到 dart 环境中。
注意: 插件版本 >= 0.0.8 android 端支持在 setup 方法中动态设置 channel,动态设置的 channel 优先级比 manifestPlaceholders 中的 JPUSH_CHANNEL 优先级要高。
JPush jPush = new JPush(); jPush.setup( appKey: "bcc3d18e3b34f08315860bea", channel: "developer-default", production: false, debug: true, // 设置是否打印 debug 日志 );
-
获取 registrationId,这个 JPush 运行通过 registrationId 来进行推送。
print("=======JPushId:${await jPush.getRegistrationID()}");
-
停止推送功能,调用该方法将不会接收到通知。
jPush.stopPush()
-
调用 stopPush 后,可以通过 resumePush 方法恢复推送。
jPush.resumePush();
-
设置别名,极光后台可以通过别名来推送,一个 App 应用只有一个别名,一般用来存储用户 id。
print("=======setAlias:${await jPush.setAlias("PushTest")}");
-
可以通过 deleteAlias 方法来删除已经设置的 alias。
print("=======deleteAlias:${await jPush.deleteAlias()}");
-
添加推送监听。
jPush.addEventHandler( // 接收通知回调方法。 onReceiveNotification: (Map<String, dynamic> message) async { print("flutter onReceiveNotification: $message"); }, // 点击通知回调方法。 onOpenNotification: (Map<String, dynamic> message) async { print("flutter onOpenNotification: $message"); }, // 接收自定义消息回调方法。 onReceiveMessage: (Map<String, dynamic> message) async { print("flutter onReceiveMessage: $message"); }, );
-
iOS10+ 可以通过下面的方法来设置推送是否前台展示,是否触发声音,是否设置应用角标 badge:
if (Platform.isIOS) {
jPush.applyPushAuthority(new NotificationSettingsIOS(sound: true, alert: true, badge: true));
}
第四步:测试推送。
- Android
-
打开极光推送后台。
极光推送后台
-
配置标题以及推送内容。
标题和内容
-
如果有需要还可以配置附加字段。
附加字段
-
Android特有的配置(选配)。
特殊配置
-
目标人群配置。
设置目标人群
-
点击发送预览。
发送预览
-
点击确定。
推送成功
遇到的问题。
1. Android最小版本必须大于等于17.
-
现象: 在Flutter项目中集成JPush后执行
编译报错flutter run
命令抛出一下异常:
-
解决:只需要将build.gradle中的minSdkVersion设置为17即可:
defaultConfig { applicationId "com.kelin.flutter_jpush_demo" minSdkVersion 17 //更改这里的版本为17 targetSdkVersion 29 versionCode flutterVersionCode.toInteger() versionName flutterVersionName }
2. Xcode7以上版本不支持http请求的问题。
-
现象:会抛出以下错误。
由于不安全,因此App Transport Security阻止了明文HTTP(http://)资源加载。可以通过应用程序的Info.plist文件配置临时异常。 意思就是:App Transport Security(应用程序传输安全)阻止了一个明文HTTP传输,因为它是不安全的,配置你的Info.plist可以临时例外(就是可以通过)
-
解决:
- 在Info.plist中添加NSAppTransportSecurity,按回车自动更改成应用程序传输安全设置,类型字典;
- 在NSAppTransportSecurity下添加NSAllowsArbitraryLoads按回车自动改变成Allowrary Loads,类型布尔值,值设置YES;
总结:
总之在Flutter中集成JPush还是比较简单的,几行代码就可以实现。但是唯一的缺点是JPush的厂商通道是收费的。
吐槽:
本来不想吐槽的,但是不吐槽心里不好受,哎……
推送这东西如果没有厂商通道支持的话到达率真的非常低,尤其是在高版本的Android系统中(iOS不存在这个问题),就这一点上感觉极光不如阿里的推送实惠。无奈阿里官方并没有出Flutter的插件。而且阿里的客服也没有极光的客服热情,等了快一个小时没有回复我,哎……。下面是与阿里客服的聊天记录:
聊天记录
以上就是我本次在Flutter项目中接入JPush整个演示过程,记录下来方便以后查阅,分享出来希望能帮到别人。好了本文结束,听懂掌声!
网友评论