帮助与文档

> >
보험연수원

前言:

MobPush1.2.0版本开始,接入华为官方,小米官方和魅族官方提供的系统级推送通道。在华为,小米和魅族的设备上,推送消息将能够通过对应的系统推送通道抵达终端,并且无需打开应用就能够收到推送,以此提高在华为,小米和魅族三种设备上的推送送达率;对于其他设备,依然走MobPush自己的通道

[注意事项]

1、MobPush1.2.0版本之后,自动判断设备选择推送通道,原本对外接口逻辑不做任何修改,自动向下兼容。

2、全部透传消息依然是由MobPush下发,三个平台的推送通道仅是下发通知栏消息

3、MobPush1.5.0版本增加了小米、魅族通道的别名标签推送,以提高推送效率,华为官方暂不支持别名标签推送则还是按照MobPush原来方式进行推送实现,后续华为官方添加此功能,MobPush也会更新优化到最新以提高推送效率和推送质量。

4、MobPush1.6.0版本增加了Oppo通道推送,Oppo推送目前不支持通知提醒类型的设置,通知声音、震动、呼吸灯等都有系统的控制,故在MobPush管理后台设置通知提醒类型对Oppo通道手机不起作用。

5、MobPush1.7.2版本开始支持角标功能,对MobPush原生通道有效,其他厂商通道由于各自厂商原因暂时不做控制,同时可支持日志调试功能,在集成厂商推送时,配置了相关信息后方便开发者确定厂商通道是否正常。

 

一、mob官网后台配置信息

1、打开http://www.mob.com,登陆到后台,添加MobPush推送SDK:

 

2、进入到特殊厂商配置选项:

 

 

 

3、进入后按需配置各个推送平台的配置信息:

如何申请四个推送平台的开发账号>>

FCM部分配置:
  1. 进入到FCM服务配置选项:

2 자극전장 다운로드. 进入后进行基础配置:

FCM证书:点击上传证书进行上传。

在上传证书之前,需要现在Firebase的控制台下载证书,然后再点击上传。

在左上角的Project Overview的图标那里选择项目设置,在右侧选择服务账号,Firebase Admin SDK 配置代码段切换到Java,点击生成新的私钥,保存下来,进行上传到Mob管理后台的FCM证书。

推送默认标题:

设置推送标题,在推送是通知消息标题采用此设置的标题,如果不设置则采用MobPush默认标题。

配置完成点击保存配置,即可~

 

二、客户端集成配置信息

1、和快速集成一样,添加引用jcenter(在项目根目录的build.gradle中添加)

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        // 注册MobSDK
        classpath 'com.mob.sdk:MobSDK:+'
       // 注册google services FCM推送需要
        classpath 'com.google.gms:google-services:4.0.0'

    }
}

2、在快速集成的基础上添加gradle的推送插件配置信息(在使用MobPush模块的build.gradle中添加)

// 添加插件
apply plugin: 'com.mob.sdk'

// 在MobSDK的扩展中注册MobPush的相关信息
MobSDK {
appKey "替换为mob官方申请的appkey"
appSecret "替换为mob官方申请的appkey对应的appSecret"

MobPush {

    //设置角标开关(不需要可不设置)
    badge true
    //集成其他推送通道(可选)
    devInfo {
        //华为推送配置信息
        HUAWEI{
            appId "华为的appid"
        }

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

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

       //设置默认推送通知显示图标
               iconRes "@mipmap/ic_launcher"

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


    }
}

附 如需要开启日志调试功能

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

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

 

注:华为推送服务需要检验签名的一致性,华为推送官网需要填写指纹证书的SHA256,在终端采用keytool -list -v -keystore keyStoreFileName 获取偶对应的指纹证书,keyStoreFileName为证书名字加后缀

另外:由于华为更新配置,需在manifest配置(若不需要上架华为可忽略):

     <receiver
            android:name="com.mob.pushsdk.plugins.huawei.PushHaiWeiRevicer">

            <intent-filter>

                <action
                    android:name="com.huawei.android.push.intent.REGISTRATION" />

                <action
                    android:name="com.huawei.android.push.intent.RECEIVE" />

                <action
                    android:name="com.huawei.android.push.intent.CLICK" />

                <action
                    android:name="com.huawei.intent.action.PUSH_STATE" />

 		<action
                    android:name="com.huawei.intent.action.PUSH_DELAY_NOTIFY" />

            </intent-filter>
    </receiver>

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

apply plugin: 'com.android.application'

dependencies {

 compile fileTree(dir: 'libs', include: ['*.jar'])

}

android {

 .. 다운로드.

}

//在build.gradle文件的最后添加

apply plugin: 'com.google.gms.google-services'

:目前vivo 厂商推送仅支持下表中的机型和对应的系统及以上系统。

详情请查看:如何申请三个推送平台的开发账号>>

3、添加防止二次混淆的代码(**重要**

-keep class com.huawei.**{*;}
-keep class com.meizu.**{*;}
-keep class com.xiaomi.**{*;}
-keep class android.os.SystemProperties
-keep class com.coloros.** {*;}
-keep class com.google.** {*;}
-keep class org.apache.thrift.**{*;}

-dontwarn com.huawei.**
-dontwarn com.meizu.**
-dontwarn com.xiaomi.**
-dontwarn android.os.SystemProperties
-dontwarn com.coloros.**
-dontwarn com.google.**
-dontwarn org.apache.thrift.**

-dontwarn com.vivo.push.**
-keep class com.vivo.push.**{*; }
-keep class com.vivo.vms.**{*; }

** 集成完毕 **,运行后可以在对应设备上可以接收到三个推送通道下发的推送消息

 

如需查询华为、魅族和小米三个推送平台开发账号申请流程 以及 离线集成方式,请点击:

华为推送集成指南>>

小米推送集成指南>>

魅族推送集成指南>>

Oppo推送集成指南>>

ViVo推送集成指南>>