MobPush Android SDK 集成指南

开发工具：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文件中 下添加上面配置,在日志控制台即可查看到TAG为MobPushLog的相关日志：

测试确认

• 确认通过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一起反馈，可加速排查进度