帮助与文档

> >

一、加入SDK

首先,解压下载回来的SDK压缩包,可以看到下面的目录结构:

image2017-3-17 14 2 1

其中“MobDependency”是CMSSDK的依赖库,“CMSSDK”是核心库,“CMSSDK-GUI”是一套开源的界面,包含了:获取资讯分类列表、资讯列表、查看资讯和发表评论等功能。

其次,将上述目录复制到您项目的工作空间,让您的项目依赖于CMSSDK-GUI。

最后,修改“AndroidManifest.xml”文件。

<!-- 添加必要的权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
 
<!-- 将Application修改为MobApplication,免去SDK初始化操作 -->
<application
        android:name="com.mob.MobApplication">
    <!-- 其它的activity -->
 
    <!-- CMSSDK的activity -->
    <activity
            android:name="com.mob.tools.MobUIShell"
            android:theme="@android:style/Theme.NoTitleBar"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:screenOrientation="portrait"
            android:windowSoftInputMode="stateHidden|adjustResize"/>
             
    <!-- 填写您从Mob开发者后台中得到的Appkey和AppSecret -->
    <meta-data android:name="Mob-AppKey" android:value="您的AppKey"/>
    <meta-data android:name="Mob-AppSecret" android:value="您的AppSecret"/>
</application>

二、代码调用

首先,有界面代码只有三个入口,都在CMSGUI类中:

方法名称 参数列表 使用说明
showNewsListPageWithUMSSDKUser 以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();

三、混淆处理

CMSSDK已经对代码做了混淆处理,请在您项目的混淆脚本中keep我们的代码,防止出现不可预知的错误:

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

相关文档