MobPush Flutter平台插件网站首页 学无止境

MobPush Flutter平台插件

MobTech袤博科技 2024-06-17 10:47:08

简介MobPush Flutter平台插件

集成准备

注册账号

使用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 {
        ...
        // 集成MobPush
          classpath "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"

    //配置MobPush
    MobPush {
        //配置厂商推送（可选配置，不需要厂商推送可不配置，需要哪些厂商推送只需配置哪些厂商配置即可）
        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)

参数	类型	作用	必填
status	bool	是否同意隐私	是
result	Function(bool)	回调	是

例：

Mobcommonlib.submitPolicyGrantResult(true, null);

日志调试

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

<meta-data
      android: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”，如下图所示

)

隐私授权

/**
 * 回传用户隐私授权结果
 * @param status     用户是否同意隐私协议
 * @param result     默认传null
 */  
Mobcommonlib.submitPolicyGrantResult(bool status, Function(bool)? result)

参数	类型	作用	必填
status	bool	是否同意隐私	是
result	Function(bool)	回调	是

例：

Mobcommonlib.submitPolicyGrantResult(true, null);

SDK API

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

/**
 * 回传用户隐私授权结果
 * @param status     用户是否同意隐私协议
 * @param result     默认传null
 */  
Mobcommonlib.submitPolicyGrantResult(bool status, Function(bool)? result)

参数	类型	作用	必填
status	bool	是否同意隐私	是
result	Function(bool)	回调	是

例：

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");
        });

删除标签（deleteTags）

deleteTags

List 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）

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）

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地址

推送证书制作

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

风语者！平时喜欢研究各种技术，目前在从事后端开发工作，热爱生活、热爱工作。

上一篇
MySQL---存储函数、触发器

下一篇
Go语言基于Viper封装实现

站长推荐

U8W/U8W-Mini使用与常见问题解决
U8W/U8W-Mini使用与常见问题解决
stm32使用HAL库配置串口中断收发数据（保姆级教程）
stm32使用HAL库配置串口中断收发数据（保姆级教程）
SpringSecurity实现前后端分离认证授权
SpringSecurity实现前后端分离认证授权
【社区图书馆】伴我前行的一本书《The C Programming Language》
【社区图书馆】伴我前行的一本书《The C Programming Language》
分享几个国内免费的ChatGPT镜像网址(亲测有效)
分享几个国内免费的ChatGPT镜像网址(亲测有效)

您现在的位置是：首页 >学无止境 >MobPush Flutter平台插件网站首页学无止境

MobPush Flutter平台插件

集成准备

注册账号

MobPush后台配置

MobPush流程图

Flutter 插件导入

Android端配置

配置Maven

配置引入

配置依赖

添加混淆代码

隐私授权

日志调试

测试确认

iOS

配置推送

Xcode 配置

隐私授权

SDK API

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

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

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

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

停止推送（stopPush）

重新打开推送服务（restartPush）

是否已停止接收推送（isPushStopped）

设置别名（setAlias）

获取别名（getAlias）

删除别名（deleteAlias）

添加标签（addTags）

获取标签（getTags）

删除标签（deleteTags）

清空标签（cleanTags）

发送本地通知（addLocalNotification）

绑定手机号（bindPhoneNum）

测试模拟推送，用于测试（send）

设置点击通知是否跳转默认页 (setClickNotificationToLaunchMainActivity 仅Android)

移除本地通知(removeLocalNotification 仅Android)

清空本地通知(clearLocalNotifications 仅)

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

设置通知静音时段（推送选项）(setSilenceTime 仅Android)

设置角标 (setBadge仅 iOS)

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

获取注册Id（getRegistrationId）

Flutter iOS端注意事项

其他问题

demo地址

推送证书制作

上一篇 MySQL---存储函数、触发器

下一篇 Go语言基于Viper封装实现

站长推荐

上一篇
MySQL---存储函数、触发器

下一篇
Go语言基于Viper封装实现