乐趣区

WKViewManager iOS 弹窗架构

前言
近来由于 App 中弹窗过多,再加上还有半透明的引导层,时常会出现多个弹窗重叠弹出,甚至会伴随引导层一起弹出,极大的影响了用户体验。
上述问题,其实很简单,只需要添加一个弹窗队列即可。
但是与此同时我们又添加了新的需求如下:

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

由于项目中我们采用了模块化的方式精简代码、降低工作耦合,所以我们的弹窗并不是基于 ViewController 弹出的,而是在需要弹出的时候获取当前显示的 ViewController 用于显示的。
例如项目中任务模块,任务是可以在任何地方任何时候被完成,任务本身不关心它是位于何时何地被完成,只需要关心完成后,需要对应做出什么操作,例如写本地数据库,更新用户数据,弹出完成任务提示,和 ViewController 并无大的关联。
简单的说,我们的弹窗是属于功能块的,而功能块不应该且不用去关心当前展示的 ViewController 是哪一个。
功能介绍
本文介绍的一个弹窗架构实际也可以归类为一个弹窗功能模块,当弹窗出现在不该出现的地方时,它来负责调度和处理,其过程对于其它功能模块透明,并不产生任何耦合度。其实现功能如下:

弹窗视图按队列依次出现
弹窗视图支持优先级模式
队列基于 ViewController,杜绝一个弹窗问题导致全局弹窗失效
弹窗视图可指定出现于某 ViewController 出现后(白名单)
ViewController 可指定不接收弹窗视图出现于自身出现时(黑名单)
实现 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

退出移动版