Flutter项目接入极光推送

2020-11-11 本文已影响0人蜗牛学开车

先奉上Demo地址

话不多说，直接开干。

第一步：注册、登陆JPush官网并创建应用

注册登陆JPush官网
添加一个项目，输入项目名称并设置图标。
创建应用
然后进行推送设置，设置Android的包名以及iOS的证书。
- Android 报名设置。
  Android推送设置
- iOS配置。
1. 用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可以临时例外（就是可以通过）

解决：
1. 在Info.plist中添加NSAppTransportSecurity，按回车自动更改成应用程序传输安全设置，类型字典；
2. 在NSAppTransportSecurity下添加NSAllowsArbitraryLoads按回车自动改变成Allowrary Loads，类型布尔值，值设置YES;
配置结果

总结：

总之在Flutter中集成JPush还是比较简单的，几行代码就可以实现。但是唯一的缺点是JPush的厂商通道是收费的。

吐槽：

本来不想吐槽的，但是不吐槽心里不好受，哎……
推送这东西如果没有厂商通道支持的话到达率真的非常低，尤其是在高版本的Android系统中(iOS不存在这个问题)，就这一点上感觉极光不如阿里的推送实惠。无奈阿里官方并没有出Flutter的插件。而且阿里的客服也没有极光的客服热情，等了快一个小时没有回复我，哎……。下面是与阿里客服的聊天记录：

聊天记录

以上就是我本次在Flutter项目中接入JPush整个演示过程，记录下来方便以后查阅，分享出来希望能帮到别人。好了本文结束，听懂掌声！