MobPush 厂商通道SDK集成指南

原创

MobService 2022-12-01 11:39:22 博主文章分类：开发者 ©著作权

文章标签 android 推送字段 文章分类 Java 后端开发

©著作权归作者所有：来自51CTO博客作者MobService的原创作品，如需转载，请与作者联系，否则将追究法律责任

开发工具：Android Studio
集成方式：Gradle在线集成
安卓版本支持：minSdkVersion 19

集成准备

MobPush快速集成

在使用厂商通道之前，请确保您已申请MobTech开发者账号并已按照MobPush快速集成文档进行集成，本篇文档将默认您已完成该步骤

Mob开发者后台配置

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

添加配置

在项目Gradle文件中注册MobSDK

buildscript {
    repositories {
        // 添加MobSDK Maven地址
        maven {
           url "https://mvn.mob.com/android"
        }
        // 配置HMS Core SDK的Maven仓地址。
        maven {
           url 'https://developer.huawei.com/repo/'}
        }
    dependencies {
        // 注册MobSDK
        classpath "com.mob.sdk:MobSDK:2018.0319.1724"
    }
}

allprojects {
    repositories {
    // 添加MobSDK Maven地址
    maven {
        url "https://mvn.mob.com/android"
    }
    // 配置HMS Core SDK的Maven仓地址。
     maven {
         url 'https://developer.huawei.com/repo/'}
     }
}

在项目App Module的Gradle文件中添加插件和扩展

// 调用MobTech SDK
apply plugin: 'com.mob.sdk'
//注册FCM推送需添加
 apply plugin: 'com.google.gms.google-services'
// 在MobSDK的扩展中注册MobPush的相关信息
MobSDK {
        appKey "替换为mob官方申请的appkey"
        appSecret "替换为mob官方申请的appkey对应的appSecret"
        MobPush {
                //集成其他推送通道（可选）
                devInfo {
                        //华为推送配置信息
                        HUAWEI{
                            appId "华为的appid"
                        }

                        //魅族推送配置信息
                        MEIZU{
                            appId "魅族的appid"
                            appKey "魅族的appkey"
                        }

                        //小米推送配置信息
                        XIAOMI{
                            appId "小米的appid"
                            appKey "小米的appkey"
                        }

                        //FCM推送通道配置
                        FCM{
                            //设置默认推送通知显示图标
                            iconRes "@mipmap/ic_launcher"
                            version "20.2.0"
                        }

                         //OPPO推送配置信息
                       OPPO{
                             appKey "OPPO的appKey"
                             appSecret "OPPO的appSecret"
                       }

                      //VIVO推送配置信息
                       VIVO {
                             appId "应用对应的vivo appID"
                             appKey "应用对应的vivo appKey"
                    }
                                        //HONOR推送配置信息
                       HONOR {
                             appId "应用对应的HONOR appID"
                    }
        }
}

添加厂商回调（可选）

跳转首页

跳转首页获取附加字段的方法：

JSONArray var =  MobPushUtils.parseMainPluginPushIntent(getIntent());
System.out.println("-------------jsonMain打印查看："+var);

返回说明

返回	字段	说明
"id":"4bu9702gmq4mvl3myo"	id	通知任务id ，仅厂商通知有该字段
{"key":"value"}	附加字段	附件字段需指定，不指定不会出现，仅厂商通知有该字段
{"from_tcp":true}	from_tcp	消息是否来自MobPushTCP通道，true：是
{"msg":"MobPushNotifyMessage{}"}	msg	消息体，对象为MobPushNotifyMessage，仅MobPushTCP通道消息有该字段
{"channel":"mobpush"}	channel	渠道名

Scheme跳转

scheme跳转获取参数方法如下

JSONArray var =  MobPushUtils.parseSchemePluginPushIntent(getIntent());
System.out.println("-------------jsonScheme打印查看："+var);

返回参数如下

返回	字段	说明
{"from_tcp":true}	from_tcp	消息是否来自MobPushTCP通道，true：是
{"msg":"MobPushNotifyMessage{}"}	msg	消息体，对象为MobPushNotifyMessage，仅MobPushTCP通道消息有该字段
{"key":"value"}	附加字段	附件字段需指定，建议不要使用url做为key
{"mobpush_link_k":"mlink://com.mob.mobpush.link"}	scheme	scheme地址
{"mobpush_link_v":"schemeKey=schemeValue"}	scheme参数	scheme地址下携带的scheme参数
{"id":"4brfm8nti9aj1arf28"}	id	推送任务id
{"channel":"xiaomi"}	channel	渠道名
{"schemeLink":"mlink://com.mobpush.demo2"}	scheme	scheme地址
{"schemeKey":"schemeValue"}	scheme参数	scheme地址下携带的scheme参数(华为，VIVO，OPPO)
{"schemeKey":"schemeValue","schemeUrl":"mlink://com.mob.mobpush.link"}	schemeUrl	scheme地址下携带的scheme参数(flyme)

小米厂商通道返回的数据打印样式

[
    {
        "mobpush_link_k": "mlink://com.mobpush.demo2",
        "mobpush_link_v": "schemeKey=schemeValue",
        "key": "value"
    },
    {
        "id": "4bqnx6rgmlseuptvy8"
    },
    {
        "channel": "xiaomi"
    },
    {
        "schemeLink": "mlink://com.mobpush.demo2"
    }
]

华为与VIVO厂商通道返回的数据打印样式

[
    {
        "schemeKey": "schemeValue"
    },
    {
        "id": "4bqoxqm2c9t5q6migw"
    },
    {
        "channel": "huawei"
    },
    {
        "mobpush_link_k": "mlink://com.mobpush.demo2",
        "mobpush_link_v": "schemeKey=schemeValue",
        "key": "value"
    },
    {
        "schemeLink": "mlink://com.mobpush.demo2"
    }
]

魅族厂商通道返回的数据打印样式

注意！魅族手机不支持跳转到指定界面，默认是跳转到首页，可以在首页获取跳转指定页面的路径，可以通过代码控制跳转

//魅族厂商不支持scheme还原跳转，但是可以在首页打印获取如下
[
    {
        "schemeKey": "schemeValue",
        "schemeUrl": "mlink://com.mobpush.demo2"
    },
    {
        "id": "4bqoxqm2cawjqwl534"
    },
    {
        "channel": "flyme"
    },
    {
        "mobpush_link_k": "mlink://com.mobpush.demo2",
        "mobpush_link_v": "schemeKey=schemeValue",
        "key": "value"
    }
]

OPPO厂商通道返回的数据打印样式

[
    {
        "mobpush_link_k": "mlink://com.mob.mobpush.linkone",
        "mobpush_link_v": "schemeKey=schemeValue",
        "onekey": "onevalue"
    },
    {
        "schemeKey": "schemeValue"
    },
    {
        "id": "32ugyk3t819xjwg"
    },
    {
        "channel": "oppo"
    },
    {
        "schemeLink": "mlink://com.mob.mobpush.linkone?pushData={\"mobpush_link_k\":\"mlink://com.mob.mobpush.linkone\",\"mobpush_link_v\":\"schemeKey=schemeValue\",\"onekey\":\"onevalue\"}&id=32ugyk3t819xjwg&channel=oppo&schemeData={\"schemeKey\":\"schemeValue\"}"
    }
]

添加防止二次混淆的代码（重要）

#厂商的混淆规则
-keep class android.os.SystemProperties
-dontwarn android.os.SystemProperties
-keep class com.huawei.**{*;}
-keep class com.meizu.**{*;}
-keep class com.xiaomi.**{*;}
-keep class com.hihonor.push.**{*; }

-dontwarn com.huawei.**
-dontwarn com.meizu.**
-dontwarn com.xiaomi.**
-dontwarn com.hihonor.push.**
-keep class com.mob.**{*;}
-dontwarn com.mob.**
-keepclasseswithmembernames class * {
    native <methods>;
}

-keepclasseswithmembers class * {
    public <init>(android.content.Context, android.util.AttributeSet);
}

-keepclasseswithmembers class * {
    public <init>(android.content.Context, android.util.AttributeSet, int);
}

-keepclassmembers class * extends android.app.Activity {
   public void *(android.view.View);
}

-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

-keep class * implements android.os.Parcelable {
  public static final android.os.Parcelable$Creator *;
}

-keep class com.huawei.hms.**{*;}
-keep class com.meizu.cloud.**{*;}
-keep class com.xiaomi.mipush.sdk.**{*;}
-keep class org.apache.thrift.**{*;}
-keep class com.google.** {*;}
-keep class com.coloros.** {*;}
-dontwarn com.huawei.hms.**
-dontwarn com.meizu.cloud.**
-dontwarn com.xiaomi.mipush.sdk.**
-dontwarn org.apache.thrift.**
-dontwarn com.google.**
-dontwarn com.coloros.**

-dontwarn com.vivo.push.**
-keep class com.vivo.push.**{*; }
-keep class com.vivo.vms.**{*; }
-keep class com.mob.pushsdk.plugins.vivo.PushVivoReceiver{*;}

-keep class com.meizu.cloud.pushsdk.MzPushMessageReceiver{
public *;
}

-keep class com.mob.pushsdk.plugins.xiaomi.PushXiaoMiRevicer {*;}
-dontwarn com.xiaomi.push.**

#这是oppo的混淆规则
-keep public class * extends android.app.Service
-keep class com.heytap.msp.** { *;}
-keep class com.mob.pushsdk.plugins.oppo.** { *;}

其他配置说明

厂商点击统计(重要)

统计厂商通道下发通知的点击数，请在点击通知打开的Activity调用该方法。

MobPush.notificationClickAck(getIntent());

日志调试功能

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

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

FCM配置说明

注：FCM通道服务需在FCM官网控制台，下载google-services.json文件，复制到应用module中：

MobPush 厂商通道SDK集成指南_字段

apply plugin: 'com.android.application'
dependencies {
      compile fileTree(dir: 'libs', include: ['*.jar'])
}
android {
       ...
}
//在build.gradle文件的最后添加
apply plugin: 'com.google.gms.google-services'

厂商限制及错误码

华为参见FAQ 错误码

小米参见小米推送消息限制说明错误码

oppo 参见FAQ PUSH运营规范

vivo 参见FAQ 错误码

魅族魅族暂未给出明确的敏感词或禁止词说明，详细以魅族文档为准或咨询魅族客服Flyme推送接入文档

上一篇：MobPush for SDK API

下一篇：MobPush 产品简介

提问和评论都可以，用心的回复会被更多人看到评论

发布评论

相关文章

官方博客	全部文章	热门标签	班级博客
了解我们	网站地图	意见反馈

鸿蒙开发者社区	51CTO学堂
51CTO	软考资讯