BBSSDK论坛移动化实现方案

一.产品介绍

BBS是一个论坛SDK项目,用户通过简单的几句代码就可以集成整个论坛模块.项目通过模块化开发,多个模块功能分离,用户可以选择需要的模块进行集成.

二.BBS整体结构

BBS的整体结构如下图所示:

BBS由三大核心模块组成:MOBFondation.framework,BBSSDK.framework,BBSSDKUI.framework.

MOBFondation.framework是公有framework,里面封装了一系列通用的功能模块,比如获取设备信息,加解密,Native和js的桥接,网络处理,数据解析......

BBSSDK.framework是数据framework,内部封装了所有数据接口.BBSSDK.framework可以独立作为SDK进行使用,只需要自己写UI,调用BBSSDK.framework,就能够实现论坛项目的开发.不过由于BBSSDK.framework引用了MOBFondation.framework,所以在使用BBSSDK.framework时,需要添加MOBFondation.framework.

BBSSDKUI.framework是对界面的封装,它以BBSSDK.framework为接口,穿插MOBFondation.framework的使用,包装成一个完整的论坛UI模块,开发者集成这个framework,可以通过简单的几句代码实现BBS的接入.

ShareSDK和MobLink通过弱引用的方式实现了BBSSDKUI的拓展,通过ShareSDK实现了对分享功能的支持,通过MobLink实现了对网页跳转App的支持.对于如何实现的弱引用,下文会有涉及.

三.BBSSDKUI功能解析

BBSSDKUI分为简约版和时尚版两个版本,各自的主界面如下图所示:

这两个版本除了展示效果的不同,功能完全一致.简约版注重UI的简洁,界面清晰利落.时尚版追求UI的炫酷,里面实现了很多毛玻璃,动画等效果.具体选择哪个版本,依据不同业务需求而定.

主界面展示了论坛和门户两大模块.这两个模块实现不同业务功能,但并不一定全部展示.展示哪个模块由后台决定,用户可以通过后台进行手动配置.

我们看一下BBSSDKUI的功能结构:

四.源码解读

开屏策略

开屏策略提供了全局必要配置,通过调用如下接口实现:

/**获取全局配置@param result 回调*/
+ (void)getGlobalSettings:(void(^)(NSDictionary *settings, NSError *error))result;复制代码

由于开屏策略必须在调用其他接口之前完成,所以这里使用了信号量进行控制: 在时尚版的BBSUIHomeViewController里,

 self.semaphore = dispatch_semaphore_create(0);self.queue = dispatch_queue_create("HomeViewControllerQueue", DISPATCH_QUEUE_SERIAL);dispatch_async(_queue, ^{//阻塞线程，直到获取配置信息完成之后dispatch_semaphore_wait(self.semaphore, DISPATCH_TIME_FOREVER);});[BBSSDK getGlobalSettings:^(NSDictionary *settings, NSError *error) {if (!error && settings){......dispatch_semaphore_signal(self.semaphore);}}];复制代码

主界面上滑左右滑效果

在时尚版的主页以及时尚版的个人中心,我们从上面的图中可以看到,tableView可以左右滑动,也可以上下滑动.当TableView左右滑动的时候,其"header"不会跟着滑动,而当TableView上下滑动的时候,其"header"会跟着滑动.这种效果是怎么实现的呢?

我们先看看这种效果的UI结构:

可见,UI大致是通过上下两个ScrollView实现的.最外层的ScrollView用来切换各个子视图(TableView).内层的ScrollView(即TableView)上下滑动.表头其实是一个UIView,通过监听TableView的contentOffSet,对表头进行Frame设置.

BBSUIPortalViewController:/**这里通过封装将TableView的实现集成到BBSUIThreadListViewController里,通过block的方式拿到contentOffSet*/
for (BBSPortalCatefories *obj in self.categoriesList) {BBSUIThreadListViewController *vc = [[BBSUIThreadListViewController alloc] initWithCatid:obj.catid allowcomment:obj.allowcomment];vc.viewType = BBSUIThreadListViewTypePortal;[vcs addObject:vc];[titles addObject:obj.catname];vc.offSetBlock = ^(CGFloat offSet){//                    NSLog(@"==============  %f",offSet);[self setContentOffSet:offSet];};vc.refreshBannerBlock = ^(NSArray *bannnerList, NSError *error) {[self _refreshBannerWithBannnerList:bannnerList error:error];};
}复制代码

/**进行表头Frame的处理*/
- (void)setContentOffSet:(CGFloat)offSet
{CGRect frame = self.headerView.frame;frame.origin.y = -offSet + _iphoneXTopPadding;self.headerView.frame = frame;_lastTableViewOffsetY = offSet;// 考虑到segmentBar,在到达navigationbar位置的时候,segmentBar需要"悬停"if (offSet <= 245 - 64){CGRect segmentFrame = self.segmentControl.frame;segmentFrame.origin.y = 245-offSet + _iphoneXTopPadding;self.segmentControl.frame = segmentFrame;}else{CGRect segmentFrame = self.segmentControl.frame;segmentFrame.origin.y = 64 + _iphoneXTopPadding;self.segmentControl.frame = segmentFrame;}if (self.offSetBlock){self.offSetBlock(offSet);}
}复制代码

弱引用的实现

BBSSDKUI对ShareSDK和MobLink采取弱引用的集成方式.在集成BBSSDKUI.framework的时候,即使不添加ShareSDK和MobLink这两个模块,也不会报错,只不过相关的功能不能使用而已.这和对BBSSDK.framework和MOBFondation.framework的强依赖是不一样的.

怎么实现的呢?

在项目初始化的时候,MOBFondation会通过hock的方式拿到所有的类名,在使用这个SDK的时候,通过协议的方式间接拿到这个类,然后通过私有方法进行调用.

- (void)_authLoginWithType:(NSInteger)type
{......NSArray *components = [[MOBFComponentManager defaultManager] getComponents:@protocol(IMOBFShareComponent)];if (components.count > 0) {id<IMOBFShareComponent>  ShareComponent = components[0];if (ShareComponent && [ShareComponent conformsToProtocol:@protocol(IMOBFShareComponent)]){[SVProgressHUD show];[ShareComponent authorize:authType settings:nil onStateChanged:^(NSInteger state, id<IMOBFSocialUser> user, NSError *error) {......}];}}else{NSLog(@"没有接入ShareSdk");}
}复制代码

这种方式避免了强依赖导致的高耦合,在接入过程中,可以选择性的接入需要的组件,不需要的组件可以不接入,但也不会报错.