WKViewManager iOS 弹窗架构

3,827 阅读5分钟

前言

近来由于App中弹窗过多,再加上还有半透明的引导层,时常会出现多个弹窗重叠弹出,甚至会伴随引导层一起弹出,极大的影响了用户体验。

上述问题,其实很简单,只需要添加一个弹窗队列即可。

但是与此同时我们又添加了新的需求如下:

  1. 广告弹窗不能出现在阅读页
  2. 订阅更新弹窗只能出现在首页
  3. 版本更新功能提示页不允许出现任何弹窗
  4. 重新安装后出现的选择性别和分类的弹窗不允许出现任何弹窗
  5. 广告观赏页面不能出现任何弹窗
  6. 由于广告和公告页面的弹出顺序不定,当弹出广告时,广告视图可点击产生跳转,但是在跳转后公告会弹出(公告具备倒计时只显示多少秒,然后自动消失),则会出现公告无法被用户看到的情况,则需要在跳转离开页面时,暂停队列

由于项目中我们采用了模块化的方式精简代码、降低工作耦合,所以我们的弹窗并不是基于ViewController弹出的,而是在需要弹出的时候获取当前显示的ViewController用于显示的。

例如项目中任务模块,任务是可以在任何地方任何时候被完成,任务本身不关心它是位于何时何地被完成,只需要关心完成后,需要对应做出什么操作,例如写本地数据库,更新用户数据,弹出完成任务提示,和ViewController并无大的关联。

简单的说,我们的弹窗是属于功能块的,而功能块不应该且不用去关心当前展示的ViewController是哪一个。

功能介绍

本文介绍的一个弹窗架构实际也可以归类为一个弹窗功能模块,当弹窗出现在不该出现的地方时,它来负责调度和处理,其过程对于其它功能模块透明,并不产生任何耦合度。其实现功能如下:

  1. 弹窗视图按队列依次出现
  2. 弹窗视图支持优先级模式
  3. 队列基于ViewController,杜绝一个弹窗问题导致全局弹窗失效
  4. 弹窗视图可指定出现于某ViewController出现后(白名单)
  5. ViewController可指定不接收弹窗视图出现于自身出现时(黑名单)
  6. 实现ViewController didDisAppear后 队列暂停,willAppear队列继续
优点

WKViewManager 弹窗队列管理类,使用AOP切片基于self-manager模式封装,高内聚性,几乎不会和ViewController或功能模块产生耦合。

劣势

由于是弹窗视图的一个管理工具,所有需要被管理的弹窗均需属于WKBaseView的子类,项目中已书写对应所需要的弹窗基类如WKPopBaseView、WKStepMaskGuideView等等,有需要构建弹窗的时候可以去查看相关类。

(关于WKBaseView,是一个封装的非常完善的弹窗基类,预计后续会写一篇文章详细介绍,它的整个结构是非常完善,针对弹窗功能几乎没有扩充瓶颈)

实现原理

白名单模式(功能点4)

白名单模式只有一个关键内容

白名单字典 - whiteList

白名单字典位于WKViewManager类中。

字典中key为从属于WKBaseView的子类的类名字符串,value是一个数组,里面放入对应的ViewController的类名字符串。

例如 白名单内容为

@{@"KMAnnouncementView":@[@"HJTMainTabBarVC"]};

则在广告公告模块中,KMAnnouncementView调用显示时,所获取的View不是HJTMainTabBarVC的View,则KMAnnouncementView会进入白名单待显示数组中,当HJTMainTabBarVC调用viewwillappear时才会实际被显示出来。

一句话介绍白名单

白名单中的key对应的view永远只会出现在其对应的value中的vc上,即便你在其他任何VC上调用显示显示KMAnnouncementView, KMAnnouncementView也只会出现在其对应的value的vc上。

黑名单模式(功能点5)

黑名单模式包括两个关键内容。

 黑名单字典 - blackList
 黑名单HomeVC - blackListHomeVCClassName

黑名单字典位于WKViewManager类中。

字典中key为ViewController的类名字符串,value是一个数组,里面应放入对应的从属于WKBaseView的子类的类名字符串。

例如 黑名单内容为

 @{@"KMBaseViewController",@[@"WKPopBaseView"]};

则表明,WKPopBaseView类(不包含其子类),如果由于功能块解耦或者其它原因,导致WKPopBaseView被展示于KMBaseViewController(不包含其子类)的子视图上时,WKViewManager会拦截此行为,将WKPopBaseView实例存入黑名单待显示数组,当回到黑名单HomeVC时再显示出来。从而实现了WKPopBaseView一定不会出现在KMBaseViewController的视图上。

一句话解释黑名单

黑名单中key对应的vc显示时,其对应的value中的view必然不会出现,如果被强制出现时,其也不会出现,直到黑名单homeVC的viewwillappear被调用才会显示。

功能点6

由于队列基于viewcontroller的,所以很简单只需要hook viewcontroller的 willappear和diddisappear即可,在willappear里面找到队列设置suspended为NO,在diddisappear里面suspended为yes即可

####Demo地址

使用方式

前提:因为内部实现使用了Masonry布局,所以需要先Pod Masonry三方库。

步骤一、

下载Demo,找到BaseView文件夹拖入项目。

步骤二、

将文件中的WKViewManagerHeader.h文件加入全局头文件.pch中。

步骤三、

新建的View继承自WKPopBaseView,并重写setInterFace,需首先调用父类的实现

- (void)setInterFace
{
    [super setInterFace];
    //TODO contentview的高度必须设置
    [self.contentView mas_makeConstraints:^(MASConstraintMaker *make) {
        make.centerX.equalTo(self);
        make.centerY.equalTo(self).offset(SCREEN_HEIGHT);
        make.width.height.equalTo(@200);
    }];
}

可自定义出现和消失动画--------实现updateContentViewConstraint:(BOOL)isShow方法

- (void)updateContentViewConstraint:(BOOL)isShow
{
    [self.contentView mas_updateConstraints:^(MASConstraintMaker *make) {
        make.centerY.equalTo(self).offset(isShow ? 0 : SCREEN_HEIGHT);
    }];
}

还有更多可自定义的效果,可通过顶层基类WKbaseVIew封装的声明周期实现。详情请查看Demo

步骤四、

初始化后,在需要展示的地方调用showInView:isShow:方法即可。

    WKTestView * v = [[WKTestView alloc] init];
    v.title = @"This is Test View can not show in HomePage";
    [v showInView:self.view isShow:YES];

交流方式

邮箱357863248@qq.com