集成筹备
这是一个基于 MobPush 性能的扩大的 Flutter 插件。应用此插件可能帮忙您在应用 Flutter 开发利用时,疾速地实现推送性能。
在pubspec.yaml文件中退出上面依赖
dependencies: mobcommonlib: mobpush_plugin:
而后执行:flutter packages get 导入package 在你的dart工程文件中,导入上面头文件,开始应用
import 'package:mobcommonlib/mobcommonlib.dart';import 'package:mobpush_plugin/mobpush_plugin.dart';
iOS
平台配置参考 iOS集成文档
实现文档中 Xcode配置:配置AppKey和AppSecret
Android
导入 MobPush 相干依赖
在我的项目根目录的build.gradle中增加以下代码:
buildscript {
repositories { // 配置Mob Maven库 maven { url "https://mvn.mob.com/android" } // 配置HMS Core SDK的Maven仓地址。(集成华为厂商须要增加) maven { url 'https://developer.huawei.com/repo/'} } ...}dependencies { ... // 集成MobPush classpath "com.mob.sdk:MobSDK:2018.0319.1724"}
}
在 /android/app/build.gradle 中增加以下代码:
apply plugin: 'com.android.application'apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"// 导入MobSDKapply plugin: 'com.mob.sdk'
平台相干集成 在我的项目的/android/app/build.gradle中增加:
MobSDK {
appKey "您的MobTech平台appKey"appSecret "您的MobTech平台appSecret"//配置MobPushMobPush { //配置厂商推送(可选配置,不须要厂商推送可不配置,须要哪些厂商推送只需配置哪些厂商配置即可) devInfo { //配置小米厂商推送 XIAOMI { appId "您的小米平台appId" appKey "您的小米平台appKey" } //配置华为厂商推送 HUAWEI { appId "您的华为平台appId" } //配置魅族厂商推送 MEIZU { appId "您的魅族平台appId" appKey "您的魅族平台appKey" } //配置FCM厂商推送 FCM { //设置默认推送告诉显示图标 iconRes "@mipmap/default_ic_launcher" } //配置OPPO厂商推送 OPPO { appKey "您的OPPO平台appKey" appSecret "您的OPPO平台appSecret" } //配置VIVO厂商推送 VIVO { appId "您的VIVO平台appId" appKey "您的VIVO平台appKey" } }}
}
增加代码
在MainActivity的onCreate中增加以下代码:
@Override protected void onCrSDK APIeate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); GeneratedPluginRegistrant.registerWith(this); }
SDK API
回传用户隐衷受权后果 (submitPrivacyGrantResult)
/** * 回传用户隐衷受权后果 * @param status 用户是否批准隐衷协定 * @param result 默认传null */ Mobcommonlib.submitPolicyGrantResult(bool status, Function(bool)? result)
例:
Mobcommonlib.submitPolicyGrantResult(true, null);
设置近程推送环境,向用户受权(setCustomNotification仅 iOS)
setCustomNotificationif (Platform.isIOS) { MobpushPlugin.setCustomNotification();}
设置近程推送环境 (setAPNsForProduction仅 iOS)
setAPNsForProductionif (Platform.isIOS) { // 开发环境 false, 线上环境 true MobpushPlugin.setAPNsForProduction(false)}
增加推送回调监听(addPushReceiver 接管自定义透传音讯回调、接管告诉音讯回调、接管点击告诉音讯回调、接管别名或标签操作回调)
addPushReceiverMobpushPlugin.addPushReceiver(_onEvent, _onError);void _onEvent(Object event) {}void _onError(Object event) {}
进行推送(stopPush)
`stopPush
MobpushPlugin.stopPush();
`
从新关上推送服务(restartPush)
restartPushMobpushPlugin.restartPush();
是否已进行接管推送(isPushStopped)
isPushStoppedMobpushPlugin.isPushStopped();
设置别名(setAlias)
setAliasMobpushPlugin.setAlias("别名").then((Map<String, dynamic> aliasMap){ String res = aliasMap['res']; String error = aliasMap['error']; String errorCode = aliasMap['errorCode']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> setAlias -> res: $res error: $error");});
获取别名(getAlias)
getAliasMobpushPlugin.getAlias().then((Map<String, dynamic> aliasMap){ String res = aliasMap['res']; String error = aliasMap['error']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> getAlias -> res: $res error: $error");});
删除别名(deleteAlias)
deleteAliasMobpushPlugin.deleteAlias().then((Map<String, dynamic> aliasMap){ String res = aliasMap['res']; String error = aliasMap['error']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> deleteAlias -> res: $res error: $error");});
增加标签(addTags)
addTagsList tags = new List();tags.add("tag1");tags.add("tag2");MobpushPlugin.addTags(tags).then((Map<String, dynamic> tagsMap){ String res = tagsMap['res']; String error = tagsMap['error']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> addTags -> res: $res error: $error");});
获取标签(getTags)
getTagsMobpushPlugin.getTags().then((Map<String, dynamic> tagsMap) { List<String> resList; if (tagsMap['res'] == null) { resList = []; } else { resList = tagsMap['res'].toList(); } String error = tagsMap['error']; print( ">>>>>>>>>>>>>>>>>>>>>>>>>>> getTags -> res: $resList error: $error"); });
删除标签(deleteTags)
deleteTagsList tags = new List();tags.add("tag1");tags.add("tag2");MobpushPlugin.deleteTags(tags).then((Map<String, dynamic> tagsMap){ String res = tagsMap['res']; String error = tagsMap['error']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> deleteTags -> res: $res error: $error");});
清空标签(cleanTags)
cleanTagsMobpushPlugin.cleanTags().then((Map<String, dynamic> tagsMap){ String res = tagsMap['res']; String error = tagsMap['error']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> cleanTags -> res: $res error: $error");});
发送本地告诉(addLocalNotification)
addLocalNotificationMobpushPlugin.addLocalNotification();
绑定手机号(bindPhoneNum)
bindPhoneNumMobpushPlugin.bindPhoneNum("110");
测试模仿推送,用于测试(send)
send/** * 测试模仿推送,用于测试 * type:模仿音讯类型,1、告诉测试;2、内推测试;3、定时 * content:模仿发送内容,500字节以内,UTF-8 * space:仅对定时音讯无效,单位分钟,默认1分钟 * extras: 附加数据,json字符串 */MobpushPlugin.send(int type, String content, int space, String extras).then((Map<String, dynamic> sendMap){ String res = sendMap['res']; String error = sendMap['error']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> send -> res: $res error: $error");});
设置点击告诉是否跳转默认页 (setClickNotificationToLaunchMainActivity 仅Android)
setClickNotificationToLaunchMainActivityMobpushPlugin.setClickNotificationToLaunchMainActivity (bool enable);
移除本地告诉(removeLocalNotification 仅Android)
removeLocalNotificationMobpushPlugin.removeLocalNotification(int notificationId);
清空本地告诉(clearLocalNotifications 仅)
clearLocalNotificationsMobpushPlugin.clearLocalNotifications();
设置告诉栏icon,不设置默认取利用icon(setNotifyIcon 仅Android)
setNotifyIconMobpushPlugin.setNotifyIcon(String resId);
设置告诉静音时段(推送选项)(setSilenceTime 仅Android)
setSilenceTime/** * 设置告诉静音时段(推送选项)(仅Android) * @param startHour 开始工夫[0~23] (小时) * @param startMinute 开始工夫[0~59](分钟) * @param endHour 完结工夫[0~23](小时) * @param endMinute 完结工夫[0~59](分钟) */MobpushPlugin.setSilenceTime(int startHour, int startMinute, int endHour, int endMinute)
设置角标 (setBadge仅 iOS)
setBadgeMobpushPlugin.setBadge(int badge);
清空角标,不革除告诉栏音讯记录 (clearBadge仅 iOS)
`clearBadgeMobpushPlugin.clearBadge();`
获取注册Id(getRegistrationId)
getRegistrationIdMobpushPlugin.getRegistrationId().then((Map<String, dynamic> ridMap) { print(ridMap); String regId = ridMap['res'].toString(); print('------>#### registrationId: ' + regId);});
Flutter iOS端注意事项
因为插件更新,SDK的Pod依赖被替换,Flutter 自身写入Pod文件不会先执行删除原有依赖,导致可能会呈现原有本地库仍然存在,请查看Pod文件夹下文件,间接手动删除mob_pushsdk 以及 MOBFoundation文件即可,如有疑难,请间接通过官网和咱们分割。
其余问题
demo地址
demo: GitHub地址
推送证书制作
推送证书申请流程见:推送证书文档