写点什么

MobPush for Flutter

  • 2022-11-27
    上海
  • 本文字数:3914 字

    阅读完需:约 13 分钟

集成准备


这是一个基于 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 onCreate(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)

setCustomNotification
if (Platform.isIOS) { MobpushPlugin.setCustomNotification();}
复制代码


设置远程推送环境 (setAPNsForProduction 仅 iOS)

setAPNsForProduction
if (Platform.isIOS) { // 开发环境 false, 线上环境 true MobpushPlugin.setAPNsForProduction(false)}
复制代码

添加推送回调监听(addPushReceiver 接收自定义透传消息回调、接收通知消息回调、接收点击通知消息回调、接收别名或标签操作回调)

addPushReceiver
MobpushPlugin.addPushReceiver(_onEvent, _onError);
void _onEvent(Object event) {
}
void _onError(Object event) {
}
复制代码

停止推送(stopPush)

stopPush
MobpushPlugin.stopPush();
复制代码

重新打开推送服务(restartPush)

restartPush
MobpushPlugin.restartPush();
复制代码

是否已停止接收推送(isPushStopped)

isPushStopped
MobpushPlugin.isPushStopped();
复制代码

设置别名(setAlias)

setAlias
MobpushPlugin.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)

getAlias
MobpushPlugin.getAlias().then((Map<String, dynamic> aliasMap){ String res = aliasMap['res']; String error = aliasMap['error']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> getAlias -> res: $res error: $error");});
复制代码

删除别名(deleteAlias)

deleteAlias
MobpushPlugin.deleteAlias().then((Map<String, dynamic> aliasMap){ String res = aliasMap['res']; String error = aliasMap['error']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> deleteAlias -> res: $res error: $error");});
复制代码

添加标签(addTags)

addTags
List 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)getTags


MobpushPlugin.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");    });
复制代码

获取标签(getTags)getTags


getTags


MobpushPlugin.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");    });
复制代码


清空标签(cleanTags)

cleanTags
MobpushPlugin.cleanTags().then((Map<String, dynamic> tagsMap){ String res = tagsMap['res']; String error = tagsMap['error']; print(">>>>>>>>>>>>>>>>>>>>>>>>>>> cleanTags -> res: $res error: $error");});
复制代码


发送本地通知(addLocalNotification)

addLocalNotification
MobpushPlugin.addLocalNotification();
复制代码


绑定手机号(bindPhoneNum)

bindPhoneNum
MobpushPlugin.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)

setClickNotificationToLaunchMainActivity
MobpushPlugin.setClickNotificationToLaunchMainActivity (bool enable);
复制代码


移除本地通知(removeLocalNotification 仅 Android)

removeLocalNotification
MobpushPlugin.removeLocalNotification(int notificationId);
复制代码


清空本地通知(clearLocalNotifications 仅)

clearLocalNotifications
MobpushPlugin.clearLocalNotifications();
复制代码


设置通知栏 icon,不设置默认取应用 icon(setNotifyIcon 仅 Android)

setNotifyIcon
MobpushPlugin.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)

setBadge
MobpushPlugin.setBadge(int badge);
复制代码


清空角标,不清除通知栏消息记录 (clearBadge 仅 iOS)

clearBadge
MobpushPlugin.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地址

推送证书制作

推送证书申请流程见:推送证书文档

发布于: 刚刚阅读数: 4
用户头像

还未添加个人签名 2019-05-08 加入

还未添加个人简介

评论

发布
暂无评论
MobPush for Flutter_MobTech袤博科技_InfoQ写作社区