帮助与文档

> >

一、获取AppKey

申请MobSDK的appkey流程

二、配置gradle

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

buildscript {
    repositories {
        jcenter()
    }

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

    }
}

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

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

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

    CMSSDK {}
}

 

三、添加代码

1、初始化MobSDK

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

MobSDK.init(this);

以初始化MobSDK。

2、调用API

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

方法名称 参数列表 使用说明
showNewsListPageWithUMSSDKUser 以UMSSDK的用户进入新闻列表,使用此接口,还需要引入UMSSDK及其依赖项目
showNewsListPageWithCustomUser String uid 用户ID
String nickname 用户昵称
String avatarUrl 用户头像URL
以当前应用的用户进入新闻列表
showNewsListPageWithAnonymousUser 以匿名用户进入新闻列表

其使用方法如下:

// 先设置界面主题,不同的主题对应不同的界面风格
CMSGUI.setTheme(DefaultTheme.class);
 
// 如果您集成了UMSSDK,可以使用下面的代码进入CMSSDK
// CMSGUI.showNewsListPageWithUMSSDKUser(com.mob.ums.gui.themes.defaultt.DefaultTheme.class);
 
// 如果您拥有自己的用户系统,可以使用下面的代码进入CMSSDK
// CMSGUI.showNewsListPageWithCustomUser("uid-123abc", "nickname", "http://www.company.com/avatar-url");
 
// 如果您希望用户以“游客”的身份查看资讯和进行评论
CMSGUI.showNewsListPageWithAnonymousUser();

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

四、混淆处理

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

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

五、注意事项

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

repositories {
    jcenter()
}

非Gradle集成方式点这里

相关文档