当前位置： 首页 > news >正文

MobPush Flutter平台插件

news 2025/7/8 12:04:28

集成准备

注册账号

使用PushSDK之前，需要先在MobTech官网注册开发者账号，并获取MobTech提供的AppKey和AppSecret，详情可以点击查看注册流程

MobPush后台配置

注册MobTech账号后，需要在MobTech后台进行相关信息的配置，详情可以点击查看具体配置信息

MobPush流程图

Flutter 插件导入

这是一个基于 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';

Android端配置

配置Maven

在项目根目录的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 {...// 集成MobPushclasspath "com.mob.sdk:MobSDK2:+"}
}

配置引入

在 /android/app/build.gradle 中添加以下代码：

// 导入MobSDK
apply 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"}}}
}

添加混淆代码

在项目中添加如下混淆代码

-keep class com.mob.**{*;}
-dontwarn com.mob.**

隐私授权

为保证您的App在集成MobSDK之后能够满足工信部相关合规要求，您应确保App安装首次冷启动且取得用户阅读您《隐私政策》授权之后，调用Mobcommonlib.submitPolicyGrantResult(true, null）回传隐私协议授权结果。反之，如果用户不同意您App《隐私政策》授权，则不能调用Mobcommonlib.submitPolicyGrantResult(true, null回传隐私协议授权结果。 请参考链接合规指南

/*** 回传用户隐私授权结果* @param status     用户是否同意隐私协议* @param result     默认传null*/  
Mobcommonlib.submitPolicyGrantResult(bool status, Function(bool)? result)
参数类型作用必填
statusbool是否同意隐私是
resultFunction(bool)回调是

例：

Mobcommonlib.submitPolicyGrantResult(true, null);

日志调试

请在AndroidManifest.xml文件中 <application>下添加上面配置,在日志控制台即可查看到TAG为MobPushLog的相关日志：

<meta-dataandroid:name="com.mob.mobpush.debugLevel"android:value="4" />

测试确认

  • 确认通过gradle已拉取到fluuter的push插件 mobpush_pligin_x.x.x
  • 确认 AppKey已经正确的写入 Androidmanifest.xml（可在app-debug.apk中的Androidmanifest查看确认）
  • 确认测试手机已经调用隐私协议接口，并上传true : Mobcommonlib.submitPolicyGrantResult(true, null);
  • 确认测试手机（或者模拟器）已成功连入网络 ＋ 客户端调用，不要使用网络代理和VPN，如果一切正常，启动项目后应有MobPushLog的日志信息，参考tag如下 

iOS

配置推送

在项目的Info.plist中添加2个字段：“MOBAppKey”和“MOBAppSecret”，对应的值是在Mob.com官方申请的应用的AppKey和AppSecret。

Xcode 配置

1.在项目中添加Capability配置：Push Notifications，如下图所示

2.在项目中添加Capability配置：Background Modes，并勾选“Remote notifications”，如下图所示

)

隐私授权

为保证您的App在集成MobSDK之后能够满足工信部相关合规要求，您应确保App安装首次冷启动且取得用户阅读您《隐私政策》授权之后，调用Mobcommonlib.submitPolicyGrantResult(true, null）回传隐私协议授权结果。反之，如果用户不同意您App《隐私政策》授权，则不能调用Mobcommonlib.submitPolicyGrantResult(true, null回传隐私协议授权结果。 请参考链接合规指南

/*** 回传用户隐私授权结果* @param status     用户是否同意隐私协议* @param result     默认传null*/  
Mobcommonlib.submitPolicyGrantResult(bool status, Function(bool)? result)
参数类型作用必填
statusbool是否同意隐私是
resultFunction(bool)回调是

例：

Mobcommonlib.submitPolicyGrantResult(true, null);

SDK API

回传用户隐私授权结果 (submitPrivacyGrantResult)

/*** 回传用户隐私授权结果* @param status     用户是否同意隐私协议* @param result     默认传null*/  
Mobcommonlib.submitPolicyGrantResult(bool status, Function(bool)? result)
参数类型作用必填
statusbool是否同意隐私是
resultFunction(bool)回调是

例：

Mobcommonlib.submitPolicyGrantResult(true, null);

设置远程推送环境，向用户授权（setCustomNotification仅 iOS）

setCustomNotificationif (Platform.isIOS) {MobpushPlugin.setCustomNotification();
}

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

setAPNsForProductionif (Platform.isIOS) {// 开发环境 false, 线上环境 trueMobpushPlugin.setAPNsForProduction(false)
}

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

addPushReceiverMobpushPlugin.addPushReceiver(_onEvent, _onError);void _onEvent(Object event) {}void _onError(Object event) {}

停止推送（stopPush）

stopPushMobpushPlugin.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）

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

推送证书制作

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

http://www.lryc.cn/news/69519.html

相关文章：

  • 机器学习面试题库：K-means
  • Linux：文本三剑客之awk
  • 如何借助Kafka持久化存储K8S事件数据？
  • 一种基于非均匀分簇和建立簇间路由的算法的无线传感器网络路由协议（Matlab代码实现）
  • usb摄像头驱动打印信息
  • 银行半结构化和无领导群面注意事项
  • 今天公司来了个拿 30K 出来的测试，算是见识到了基础的天花板
  • SSM整合（单元测试、结果封装、异常处理）
  • C++ list
  • 【JavaScript】ES6新特性（2）
  • CST-FSS/周期谐振单元的仿真
  • 重新理解RocketMQ Commit Log存储协议
  • ROS 开发环境搭建（虚拟机版本）（一）
  • vue3做项目是需要注意的事项
  • docker日志轮转
  • 论文阅读_音频压缩_Encodec
  • 第06章_多表查询
  • 自学黑客（网络安全）有哪些技巧——初学者篇
  • CMD与DOS脚本编程【第四章】
  • Liunx安装Docker
  • docker：容器的数据卷
  • 【TCP】对TCP三次握手的个人理解
  • squid的基本代理
  • 【从零开始写视觉SLAM】v0.1基于特征点的简单VO
  • CentOS-7 安装 MariaDB-10.8
  • Packet Tracer – 对 VLAN 实施进行故障排除 – 方案 1
  • 五、c++学习（加餐1：汇编基础学习）
  • iOS正确获取图片参数深入探究及CGImageRef的使用(附源码)
  • Typescript 5.0 发布：快速概览
  • 【图像处理 】卡尔曼滤波器原理