帮助与文档

> >

一、获取AppKey

1.如何在mob上创建应用添加产品,并且得到appkey和appsecret可以参考这个注册应用的流程。

二、配置gradle

1、打开项目根目录的build.gradle,在buildscrip–>dependencies 模块下面添加  classpath ‘com.mob.sdk:MobSDK:+’,如下所示;

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        ...
        classpath 'com.mob.sdk:MobSDK:+'

    }
}

2、在使用UMSSDK模块的build.gradle中,添加MobSDK插件和扩展,如:

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

// 在MobSDK的扩展中注册UMSSDK的相关信息
MobSDK {
    appKey "d580ad56b4b5"
    appSecret "7fcae59a62342e7e2759e9e397c82bdd"

    UMSSDK {}
    
    // UMSSDK依赖于ShareSDK和SMSSDK,故还需要引入这两个SDK
    ShareSDK {
        gui false
        devInfo {
            SinaWeibo {
                appKey "568898243"
                appSecret "38a4f8204cc784f81f9f0daaf31e02e3"
                callbackUri "http://www.sharesdk.cn"
                shareByAppClient false
            }
            Wechat {
                appId "wx4868b35061f87885"
                appSecret "64020361b8ec4c99936c0e3999a9f249"
            }
            QQ {
                appId "100371282"
                appKey "aed9b0303e3ed1e27bae87c33761161d"
            }
        }
    }
    SMSSDK {
        gui false
    }
}

关于ShareSDK和SMSSDK的详细说明,请参考其各自的集成文档。

三、添加代码

1、初始化MobSDK

如果您没有在`AndroidManifest`中设置`appliaction`的类名,MobSDK会将这个设置为`com.mob.MobApplication`,但如果您设置了,请在您自己的Application类中调用:

MobSDK.init(this);

以初始化MobSDK。

2、调用API

UMSSDK提供两套API:有界面API和无界面API,其中有界面API有如下3个入口,都在UMSGUI类中:

方法名称 参数列表 使用说明
showLogin OperationCallback<User> callback
操作回调,成功后会返回一个User对象,包含当前用户的详细资料。
打开登录页面,可在页面中执行注册、登录、重置密码和第三方登录。
showProfilePage 打开我的资料页面。如果此前没有登录,则会先执行登录,在登录完成后才显示资料页面
showRecommendationPage 打开最近登录列表页。通过最近登录列表进入用户详情页,查看用户信息进行添加好友、添加关注、拉黑等。

其使用方法如下:

//打开我的资料页面。如果此前没有登录,则会先执行登录,在登录完成后才显示资料页面
UMSGUI.showProfilePage();

 四、OperationCallback

OperationCallback是UMSSDK所有异步操作的结果回调,包含下面3个方法:

方法名称 参数列表 使用说明
onSuccess Object data 具体操作的结果数据 成功回调
onFailed Throwable t 具体操作的异常堆栈 错误回调
onCancel 取消回调

## 无界面API使用说明,请参阅[无GUI界面集成]

五、混淆处理

UMSSDK已经做了混淆处理,再次混淆会导致不可预期的错误,请在您的混淆脚本中添加如下的配置,跳过对UMSSDK的混淆操作

-keep class com.mob.**{*;}
-keep class cn.sharesdk.**{*;}
-keep class cn.smssdk.**{*;}
-dontwarn com.mob.**

六、注意事项

1. UMSSDK默认会添加一套开源的GUI库,如果您不需要这个库,可以在`UMSSDK`下设置“gui false”来关闭它
2. MobSDK默认为UMSSDK提供最新版本的集成,如果您想锁定某个版本,可以在`UMSSDK`下设置“version "某个版本"”来固定使用这个版本
3. 如果使用MobSDK的模块会被其它模块依赖,请确保依赖它的模块也引入MobSDK插件,或在此模块的gradle中添加:

repositories {
    jcenter()
}

非Gradle集成方式点这里

相关文档