BBSSDK论坛移动化实现方案

最新推荐文章于 2023-09-24 08:00:00 发布

weixin_33739541

最新推荐文章于 2023-09-24 08:00:00 发布

阅读量180

点赞数

文章标签： ui python

原文链接：https://my.oschina.net/u/3773669/blog/1647656

版权

2019独角兽企业重金招聘Python工程师标准>>>

一.产品介绍

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");
    }
}

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

转载于:https://my.oschina.net/u/3773669/blog/1647656