jpush-hbuilder-plugin

极光推送 官方支持的 Hbuilder 插件(Android & iOS)。是基于 HBuilder 提供的 uni-app 原生插件扩展 进而开发出的推送插件。

支持 iOS 和 Android 推送,同时适配各大厂商推送。

uniapp插件市场地址

极光推送官方SDK

接入

  • 1.将 nativeplugins/JG-JPush 导入项目对应位置。
  • 2.项目 manifest.json 中接入 JG-JPush 插件,并配置插件配置。
  • 3.在项目中引用插件
const jv = uni.requireNativePlugin('JG-JPush');
  • 4.引入JG-JCore 插件,用于适配更多的极光 Uniapp 插件,必须引入。

DEMO 体验

按照以下步骤快速体验 JPush_Hbuilder_demo:

  • 1.在极光 portal注册应用并开通推送功能。
  • 2.在项目 manifest.json 中配置您的推送信息
  • 3.HbuilderX 中制作打包自定义基座,包名,签名,bundleID 需要与对应 appkey 配置的应用信息保持一致
  • 4.HbuilderX 使用自定义基座运行即可

1.2 配置插件

注意:不要勾选uniPush!

打开 manifest.xml,选中App原生插件配置,选择本地插件,导入 JG-JPush

然后配置各个属性,注意在HBuilderX中可能会出现乱序现象,请仔细认真填写

属性 描述 示例
JPUSH_OPPO_APPKEY android oppo appkey(选填) OP-12345678
JPUSH_OPPO_APPID android oppo appid(选填) OP-12345678
JPUSH_OPPO_APPSECRET android oppo appSecret(选填) OP-12345678
JPUSH_VIVO_APPKEY android vivo appkey(选填) 12345678
JPUSH_VIVO_APPID android vivo appId(选填) 12345678
JPUSH_MEIZU_APPKEY android meizu appkey(选填) MZ-12345678
JPUSH_MEIZU_APPID android meizu appId(选填) MZ-12345678
JPUSH_XIAOMI_APPKEY android xiaomi appKey(选填) MI-12345678
JPUSH_XIAOMI_APPID android xiaomi appId(选填) MI-12345678
JPUSH_ISPRODUCTION_IOS iOS 是否是生产环境(选填) 是填true,不是填false或者不填
JPUSH_ADVERTISINGID_IOS iOS 广告标识符(IDFA)(选填) 如果不需要使用IDFA,可不填
JPUSH_DEFAULTINITJPUSH_IOS iOS 是否默认初始化(选填) 是填true,不是填false或者不填

Android 厂商配置说明

插件支持 OPPO VIVO 魅族 小米 四大厂商推送接入,如需接入请对应配置上述厂商信息。

因华为,FCM 厂商需要单独配置 json 及对应原生插件库,不在此插件支持范围,如需接入,需使用 Uniapp 本地打包导入 AndroidStudio,并按照极光厂商接入文档自行配置接入。

API

参考资料

官方文档

Support

  • 集成前请先尝试 demo 工程跑通
  • 出现问题请先打开 debug 模式,拿到前端和原生日志
  • 更多问题请前往极光社区

License

MIT © JiGuang