Flutter项目接入极光推送

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


最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容