美文网首页Flutter圈子Flutter
Flutter项目接入极光推送

Flutter项目接入极光推送

作者: 蜗牛学开车 | 来源:发表于2020-11-11 10:03 被阅读0次

    先奉上Demo地址

    话不多说,直接开干。


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

    • 注册登陆JPush官网

    • 添加一个项目,输入项目名称并设置图标。

      创建应用
    • 然后进行推送设置,设置Android的包名以及iOS的证书。

      • Android 报名设置。

        Android推送设置
      • iOS配置。

      1. 用Xcode打开我们的项目,或者项目目录中找到 ios-> Runner.xcodeproj 然后双击Runner.xcodeproj运行。


        用Xcode打开项目
    1. 在Runner中设置 Bundle Identifier的值为正确的包名。


      配置包名
    1. 为了防止在编译时会自动变更,所以最好将info.plist中的配置也修改一下。


      配置包名
    1. 证书配置。

      由于我没有苹果开发者的账号,所以这一步我无法操作。有兴趣的可以参考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
    1. 打开极光推送后台。


      极光推送后台
    1. 配置标题以及推送内容。


      标题和内容
    1. 如果有需要还可以配置附加字段。


      附加字段
    1. Android特有的配置(选配)。


      特殊配置
    1. 目标人群配置。


      设置目标人群
    1. 点击发送预览。


      发送预览
    1. 点击确定。


      推送成功

    遇到的问题。

    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整个演示过程,记录下来方便以后查阅,分享出来希望能帮到别人。好了本文结束,听懂掌声!


    相关文章

      网友评论

        本文标题:Flutter项目接入极光推送

        本文链接:https://www.haomeiwen.com/subject/wnwjbktx.html