开发工具:Android Studio
集成方式:Gradle在线集成
安卓版本支持:minSdkVersion 19
集成准备
注册账号
使用PushSDK之前,需要先在MobTech官网注册开发者账号,并获取MobTech提供的AppKey和AppSecret,详情可以点击查看注册流程
MobPush后台配置
注册MobTech账号后,需要在MobTech后台进行相关信息的配置,详情可以点击查看具体配置信息
MobPush流程图
集成配置
配置Maven
在项目Gradle文件中注册MobSDK的Maven地址
buildscript {
repositories {
// 1.添加MobSDK Maven地址
maven {
url "https://mvn.mob.com/android"
}
}
dependencies {
// 2.注册MobSDK
classpath "com.mob.sdk:MobSDK2:+"
}
allprojects {
repositories {
maven {
url "https://mvn.mob.com/android"
}
}
}
}
配置依赖
在项目App Module的Gradle文件中添加插件和MobSDK块(如果是多moudle项目,请在子moudle和主module下均配置以下代码)
// 调用MobTech SDK
apply plugin: 'com.mob.sdk'
MobSDK {
appKey "替换为MobTech官方申请的appkey"
appSecret "替换为MobTech官方申请的appkey对应的appSecret"
MobPush {}
}
配置标识
在gradle.properties中添加代码
MobSDK.spEdition=FP
配置混淆代码
在项目中添加如下混淆代码
-keep class com.mob.**{*;}
-dontwarn com.mob.**
隐私授权
回传用户隐私授权结果(submitPolicyGrantResult)
为保证您的App在集成MobSDK之后能够满足工信部相关合规要求,您应确保App安装首次冷启动且取得用户阅读您《隐私政策》授权之后,调用MobSDK.submitPolicyGrantResult回传隐私协议授权结果。
反之,如果用户不同意您App《隐私政策》授权,则不能调用MobSDK.submitPolicyGrantResult回传隐私协议授权结果。 请参考链接合规指南
/**
* com.mob.MobSDK.class
* 回传用户隐私授权结果
* @param isGranted 用户是否同意隐私协议
*/
public static void submitPolicyGrantResult(boolean isGranted)
示例代码 注:调用位置开发者可以自己指定,只需在使用SDK功能之前调用即可,强烈建议开发者在终端用户点击应用隐私协议弹窗同意按钮后调用。
MobSDK.submitPolicyGrantResult(true);
日志调试
请在AndroidManifest.xml文件中 <application>
下添加上面配置,在日志控制台即可查看到TAG为MobPushLog的相关日志:
<meta-data
android:name="com.mob.mobpush.debugLevel"
android:value="4" />
测试确认
-
确认通过gradle已拉取到资源包,包名为:"com.mob:MobSupportV1:xxxxxxxxx";"com.mob:MobCoreULT:xxxxxxxxx";"com.mob:MobGUIULT:xxxxxxxxx@aar";"com.mob:PushSDK:xxx@aar"
-
确认 AppKey已经正确的写入 Androidmanifest.xml(可在app-debug.apk中的Androidmanifest查看确认)
-
确认测试手机已经调用隐私协议接口,并上传true : MobSDK.submitPolicyGrantResult(true);
-
确认测试手机(或者模拟器)已成功连入网络 + 客户端调用,不要使用网络代理和VPN,如果一切正常,启动项目后应有MobPushLog的日志信息,参考tag如下
功能进阶
Registration ID 使用说明
获取: 关于获取Registration ID,请点击查看MobPushSDK API 使用
使用说明: 由于MobPush推送所有形式的推送最后都会转化为对 Registration ID 推送,因此 Registration ID是推送和关联用户信息必备的标识。同时为了方便线上客户准确提供信息,减少沟通成本,我们建议您完成 SDK 集成后,将Registration ID 进行存储和记录,排查问题时可将Registration ID和任务ID一起反馈,可加速排查进度