更新记录
1.1.3(2024-10-26) 下载此版本
ios and android sdk update to version 4.5.1
1.1.2(2024-07-11) 下载此版本
- 更新iOS、Android 原生SDK为4.4.0版本
1.1.1(2024-06-27) 下载此版本
- ios 更新到4.3.5版本,安卓更新到4.3.9版本。
- iOS、安卓不再需要填写数据中心,去掉package.json的数据中心配置。
- 安卓不再提供小米国外版通道,新增支持小米国内版通道。
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 14.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:11 - 17 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
mtpush-hbuilder-plugin
EngageLab AppPush 官方支持的 Hbuilder 插件(Android & iOS)。是基于 HBuilder 提供的 uni-app 原生插件扩展 进而开发出的推送插件。
支持 iOS 和 Android 推送,同时适配各大厂商推送。
uniapp插件市场地址
接入
- 1.将 nativeplugins/EL-MTPush 导入项目对应位置。
- 2.项目 manifest.json 中接入 EL-MTPush 插件,并配置插件配置。
- 3.在项目中引用插件
const jv = uni.requireNativePlugin('EL-MTPush');
DEMO 体验
按照以下步骤快速体验 MTPush_Hbuilder_demo:
- 1.在EngageLab portal注册应用并开通推送功能。
- 2.在项目 manifest.json 中配置您的推送信息
- 3.HbuilderX 中制作打包自定义基座,包名,签名,bundleID 需要与对应 appkey 配置的应用信息保持一致
- 4.HbuilderX 使用自定义基座运行即可
1.2 配置插件
HBuilderX 3.6.2 及之后版本,请打开mainfest配置文件,选择 App模块配置,勾选 Push 模块。
注意:不要勾选uniPush!
打开 manifest.xml,选中App原生插件配置,选择本地插件,导入 EL-MTPush
然后配置各个属性,注意在HBuilderX中可能会出现乱序现象,请仔细认真填写
属性 | 描述 | 示例 |
---|---|---|
MTPUSH_APPKEY_ANDROID | engagelab appkey (必填) | EngageLab portal配置应用信息时分配的AppKey |
MTPUSH_CHANNEL_ANDROID | engagelab channel (选填) | 用于统计分发渠道,不需要可填默认值developer-default |
MTPUSH_PROCESS_ANDROID | Engagelabsdk work thread (必填) | Engagelab process,Engagelabsdk工作所在的进程,请填写 :remote |
MTPUSH_OPPO_APPKEY | android oppo appkey(选填) | OP-12345678 |
MTPUSH_OPPO_APPID | android oppo appid(选填) | OP-12345678 |
MTPUSH_OPPO_APPSECRET | android oppo appSecret(选填) | OP-12345678 |
MTPUSH_VIVO_APPKEY | android vivo appkey(选填) | 12345678 |
MTPUSH_VIVO_APPID | android vivo appId(选填) | 12345678 |
MTPUSH_HONOR_APPID | android honor appId(选填) | 12345678 |
MTPUSH_MEIZU_APPKEY | android meizu appkey(选填) | MZ-12345678 |
MTPUSH_MEIZU_APPID | android meizu appId(选填) | MZ-12345678 |
MTPUSH_XIAOMI_APPKEY | android xiaomi appKey(选填) | MI-12345678 |
MTPUSH_XIAOMI_APPID | android xiaomi appId(选填) | MI-12345678 |
MTPUSH_HUAWEI_APPID | android huawei appId(选填) | appid=12345678 |
MTPUSH_GOOGLE_API_KEY | G-拼接google-services.json下的current_key(选填) | G-12345678 |
MTPUSH_GOOGLE_APP_ID | G-拼接google-services.json下的mobilesdk_app_id(选填) | G-12345678 |
MTPUSH_GOOGLE_PROJECT_ID | G-拼接google-services.json下的project_id(选填) | G-12345678 |
MTPUSH_GOOGLE_PROJECT_NUMBER | G-拼接google-services.json下的project_number(选填) | G-12345678 |
MTPUSH_GOOGLE_STORAGE_BUCKET | G-拼接google-services.json下的storage_bucket(选填) | G-12345678 |
MTPUSH_APPKEY_IOS | engagelab appkey (必填) | EngageLab portal配置应用信息时分配的AppKey |
MTPUSH_CHANNEL_IOS | engagelab channel (选填) | 用于统计分发渠道,不需要可填默认值developer-default |
MTPush_ISPRODUCTION_IOS | iOS 是否是生产环境(选填) | 是填true,不是填false或者不填 |
MTPush_ADVERTISINGID_IOS | iOS 广告标识符(IDFA)(选填) | 如果不需要使用IDFA,可不填 |
MTPush_DEFAULTINITPUSH_IOS | iOS 是否默认初始化(选填) | 是填true,不是填false或者不填 |
Android 厂商配置说明
插件支持 OPPO VIVO 魅族 小米 华为 FCM 荣耀七大厂商推送接入,如需接入请对应配置上述厂商信息。
API
参考资料
Support
- 集成前请先尝试 demo 工程跑通
- 出现问题请先打开 debug 模式,拿到前端和原生日志
Licensemtpush
MIT © EngageLab