开发工具: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 一起反馈,可减速排查进度