帮助与文档

> >

介绍

按照快速集成文档,您可以很容易的把BBSSDK提供的功能集成到您的应用中,然后使用BBSSDK来做开发。

在集成前,您也可以先下载示例Sample的源码工程(包含应用内打开pdf\office等格式文件)。使用Android Studio打开后,编译出网站上提供的演示应用。

其github开源地址如下:

https://github.com/MobClub/BBSSDK-for-Android

一、获取AppKey

申请MobSDK的appkey流程

二、配置gradle

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

buildscript {
    repositories {
        jcenter()
    }

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

    }
}

2、在使用BBSSDK模块的build.gradle中,添加MobSDK插件和扩展,要注意需要在BBSSDK标签下加上具体的版本号如version "2.3.0"、version "2.2.0"之类的具体版本。如:

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

// 在MobSDK的扩展中注册BBSSDK的相关信息
MobSDK {
    appKey "21b0f455db50c"
    appSecret "70d65618dbd258834a3c05ea49df878c"

    BBSSDK{
        theme 'theme1'
        //高德地图配置
        devInfo {
            GadMap {
                apiKey "ed7498703ea40c2a89ca7bd301f1c9d2"
            }
        }

    }

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

其中的`theme`表示使用的界面风格,暂时BBSSDK具备两套界面风格:`theme0`和theme1,高德地图的apikey需要自行去高德开放平台申请,如果不想要地图功能也可以不配置BBSSDK标签下的devInfo。
关于ShareSDK和MobLink的详细说明,请参考其各自的集成文档。

三、添加代码

1、初始化MobSDK

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

MobSDK.init(this);

以初始化MobSDK。

2、初始化主题

BBSTheme0.init();

或者

BBSTheme1.init();

注意要和上面build.gradle配置的theme一致

3、添加论坛主界面

在您的layout,或者想加的界面上添加下面配置

<com.mob.bbssdk.theme0.view.Theme0MainView
    android:id="@+id/mainView"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
</com.mob.bbssdk.theme0.view.Theme0MainView>

在您的界面中添加MainView,并调用loadData()方法加载数据:

MainViewInterface mainView = (MainViewInterface) findViewById(ResHelper.getIdRes(this, "mainView"));

mainView .loadData();

四、混淆设置

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

-keep class com.mob.**{*;}
-keep class cn.sharesdk.**{*;}
-dontwarn com.mob.**
#高德地图
#定位
-keep class com.amap.api.location.**{*;}
-keep class com.amap.api.fence.**{*;}
-keep class com.autonavi.aps.amapapi.model.**{*;}

#搜索
-keep   class com.amap.api.services.**{*;}

#3D 地图 V5.0.0之后:
-keep   class com.amap.api.maps.**{*;}
-keep   class com.autonavi.**{*;}
-keep   class com.amap.api.trace.**{*;}

五、注意事项

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

repositories {
    jcenter()
}