jpush_flutter_android

集成极光推送的 Android 厂商通道 SDK 的 Flutter 插件。

环境要求

需与 jpush_flutter 插件配合使用。

版本对应关系

jpush_flutter	jpush_flutter_android
3.5.8+	1.1.4+
3.5.8+	1.1.1-1.1.3
3.5.7+	1.1.0
3.4.8+	1.0.2
3.4.5+	1.0.1
3.4.3+	0.0.10+
3.3.8+	0.0.9
3.3.2+	0.0.7-0.0.8
3.2.4-3.3.1	0.0.5-0.0.6
3.2.0-3.2.3	0.0.4
3.1.9	不建议使用
3.1.8	0.0.3
3.0.9-3.1.7	0.0.1-0.0.2

快速开始

添加依赖

将 jpush_flutter_android 添加至 pubspec.yaml 引用

dependencies:
  jpush_flutter: ^latest_version
  jpush_flutter_android: ^latest_version

jpush_android:
  app_key: xxx
  channel: xxx
  huawei:
    enable: true # 默认为false
  xiaomi:
    enable: true # 默认为false
    app_key: xxx
    app_id: xxx
  meizu:
    enable: true # 默认为false
    app_key: xxx # MZ- 已默认配置，只需参数即可
    app_id: xxx # MZ- 已默认配置，只需参数即可
  vivo:
    enable: true # 默认为false
    app_key: xxx
    app_id: xxx
  oppo:
    enable: true # 默认为false
    app_key: xxx # OP- 已默认配置，只需参数即可
    app_id: xxx # OP- 已默认配置，只需参数即可
    app_secret: xxx # OP- 已默认配置，只需参数即可
  honor:
    enable: true # 默认为false
    app_id: xxx

相关配置

官方文档 - 厂商通道参数申请指南

官方文档 - 厂商通道 SDK 集成指南

官方文档 - 厂商通道回执配置指南

官方文档 - 厂商限额及 QPS 限制

官方文档 - 厂商消息分类使用指南

配置参数

从 1.0.0 版本起，只需在 pubspec.yaml 配置即可。

在 build.gradle 中添加如下参数

android {
  ......
  
  defaultConfig {
    applicationId = "xx.xx.xx"
    ......
    
    manifestPlaceholders = [
        JPUSH_PKGNAME     : applicationId,
        JPUSH_APPKEY      : "你的 Appkey", // JPush 上注册的包名对应的 Appkey.
        JPUSH_CHANNEL     : "developer-default", // 暂时填写默认值即可.
        XIAOMI_APPKEY     : "您的应用对应的小米的APPKEY",
        XIAOMI_APPID      : "您的应用对应的小米的APPID",
        MEIZU_APPKEY      : "MZ-您的应用对应的魅族的APPKEY",
        MEIZU_APPID       : "MZ-您的应用对应的魅族的APPID",
        VIVO_APPKEY       : "您的应用对应的VIVO的APPKEY",
        VIVO_APPID        : "您的应用对应的VIVO的APPID",
        OPPO_APPKEY       : "OP-您的应用对应的OPPO的APPKEY",
        OPPO_APPID        : "OP-您的应用对应的OPPO的APPID",
        OPPO_APPSECRET    : "OP-您的应用对应的OPPO的APPSECRET",
        HONOR_APPID       : "您的应用对应的Honor的APPID"
    ]
  }
}

配置代码混淆

代码混淆规则已集成在插件内（通过 consumer ProGuard 规则自动合并），无须额外配置。

宿主 App 开启 minifyEnabled true（R8）后无需任何处理：JPush 及各厂商通道的类由插件发布的 -keep 规则整体保护，R8 的优化与混淆均可正常工作。

注意：1.1.3 及以下版本的 consumer 规则中包含 -dontoptimize / -dontpreverify 全局选项，在 AGP 8.x 下会导致构建失败（Global keep option -dontoptimize was specified as a consumerProguardFile），请升级到 1.1.4+。升级到 1.1.4+ 后请勿在宿主配置中补加这两个选项——是否优化由宿主构建配置自行决定，JPush SDK 在 R8 优化下可正常工作。

配置权限

所需的基础权限已经集成在配置的jar文件包内，无须额外配置。

配置华为推送

配置 agconnect-services.json 文件

参考 厂商通道参数申请指南 获取 agconnect-services.json 文件，并配置到 app 目录下。