帮助与文档

> >

BBSSDKGUI提供了一些基础界面以及基础控件(附源码),用户可自己权衡修改和使用。下面说明其中主要的界面和控件:

(更详细的API说明请见下载的SDK中的BBSSDK for Android ApiDoc或者自行查看源码)

一、集成、初始化和配置sdk

1、申请MobSDK的appkey流程

2、点击进入下载界面

3、解压下载的ZIP包,将其中BBSSDKGUI/BBSSDKTHEME1/BBSSDKTHEME0

工程导入到新项目中,并添加项目依赖关系即可。

4、配置Manifest文件

添加权限

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.GET_TASKS"/>
<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"/>

 在application标签内添加activity信息

<application
       android:name="com.mob.MobApplication">
      <activity android:name="com.mob.tools.MobUIShell" 
 android:configChanges="keyboardHidden|orientation|screenSize" 
android:screenOrientation="portrait" 
android:windowSoftInputMode="stateHidden|adjustResize"> <intent-filter> 
<action android:name="android.intent.action.VIEW"/> <category android:name="android.intent.category.DEFAULT"/> </intent-filter> 
</activity>

</application>

在application标签内添加meta信息

<meta-data
     android:name="Mob-AppKey"
     android:value="替换为mob官方申请的appkey"/>
<meta-data
     android:name="Mob-AppSecret"
     android:value="替换为mob官方申请的appkey对应的appSecret"/>

5. 初始化SDK

在您App的Application中或者调用SDK的API前,请先调用如下方法进行初始化

MobSDK.init(context);

BBSTheme0.init();       //简约界面
//BBSTheme1.init();   //时尚界面

6、添加论坛主界面

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

<com.mob.bbssdk.gui.views.MainView
    android:id="@+id/mainView"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
</com.mob.bbssdk.gui.views.MainView>

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

MainView mainView = new MainView (context);
mainView.loadData();

二、View控件

使用方式:代码布局或者xml布局

    1.  TitleBar 标题栏
    2.  EmptyView 请求列表为空的View
    3.  ForumForumView 主页面置顶板块配置的View
    4.  ForumImageViewer 浏览图片的View
    5.  ForumThreadDetailView 帖子详情的View
    6.  ForumThreadListView 帖子列表的View
    7.  ForumThreadView 主页面主题帖子列表的View
    8.  IOSLoadingView 仿IOS风格的加载View
    9.  LoadingView 请求加载的View
    10.  MainView 论坛主页面的View
    11.  RequestLoadingView 请求加载的View
    12.  RichEditor 富文本编辑器的View
    13.  SelectForumView 论坛板块选择的View

三、Activity界面

使用上面控件组装的activity界面

使用方式:(以PageMain界面为例)

PageMain pageMain = new PageMain();
pageMain.show(context);
pageMain.showForResult(context, new FakeActivity(){
   public void onResult(HashMap<String, Object> data) {
   //TODO 界面返回回调
   }
});
    1.  account/PageLogin 登录页面。
    2. account/PageReactiveConfirm 激活确认页面。
    3. account/PageRegister 注册页面。
    4. account/PageRegisterConfirm 注册确认页面。
    5. account/PageRetrievePassword 找回密码页面。
    6. account/PageRetrievePasswordConfirm 找回密码确认页面。
    7. forum/PageAttachmentViewer 附件浏览页面。
    8. forum/PageForumThread 板块帖子列表页面。
    9. form/PageForumThreadDetail 帖子详情页面。
    10. forum/PageImageViewer 图片浏览页面。
    11. forum/PageMain 主页面。
    12. forum/PageReportAccusation 举报页面。
    13. forum/PageSearch 搜索页面。
    14. forum/PageSelectForum 板块选择页面。
    15. forum/PageWriteThread 编辑帖子页面。
    16. misc/PageFavorites 收藏帖子列表页面。
    17. misc/PageFollowers 粉丝列表页面。
    18. misc/PageFollowings 关注列表页面。
    19. misc/PageHistory 帖子浏览历史页面。
    20. misc/PageMessageDetails 消息详情页面。
    21. misc/PageMessages 消息列表页面。
    22. misc/PagePosts 发过的帖子列表页面。
    23. misc/PageEditSignature 编辑签名页面。
    24. misc/PageInitProfile 初始化个人资料页面。
    25. misc/PageOtherUserProfile 其他用户资料页面。
    26. misc/PageUserProfile 个人用户资料页面。
    27. misc/PageUserProfileDetails 个人用户资料详情页面。