任何App,无论大小,都存在繁杂的页面跳转,按照正常的逻辑处理,那就是在发起的地方实例化一个targetVC,然后 push/present,但如果频繁的这样操作,你会发现随着版本迭代,一旦出现代码修改(原有VC命名修改、入参修改等等),你所要付出的代价也极大,而且风险极高,说不定漏掉了某个发起跳转的地方没有修改,导致产品线上报错甚至Crash掉;所以此种代码耦合度是架构设计时必须要考虑并解决的。所以受早期阿里相关开发人员的思维启发(利用url进行页面跳转),在2016年开始,我们小组内部开始设计并使用相关的OC版路由跳转工具,并在之后使用swift进行了优化,简单说一下实现思路,最后会附上源码下载地址,方便大家使用。
封装此工具的目标
· 摆脱实例化target viewController 然后push/present的方式
· 节假日活动弹窗、活动页面可以灵活调用跳转其他本地页面
关键思路整理
1、基于反射机制,我们可以通过字符串得到一个类甚至去创建一个对象。
2、建立一套继承机制或者这协议,让所有ViewController都执行关键方法,这个方法中就可以进行数据的传递,也就是通过此方法传入参数
3、移动端分为安卓、iOS,不可能要求页面命名相同,那么也就意味着需要建立一个返回数据的标准,同时,移动端自己有一个翻译工具,对返回数据进行规范化解析以正确翻译跳转指令
4、为了方便本地译本日后的维护扩展,并且容易阅读了解,可以考虑创建一个plist文件进行统一管理
5、一段url中可以拿到host、body、和参数等等,所以后台可以将指令拼接成一段完整的url,移动端解析并跳转
方案设计
整体思路就是这样,其实核心点就在于指令的处理,下面把我的工具发出来,大家可以自由下载使用。
工具需要在AppDelegate中进行服务注册和基本配置
/// 配置全局路由
func installRouter() {
TSRouter.shared.transferOriginViewController = {
let currentAppDele = UIApplication.shared.delegate as! AppDelegate
if currentAppDele.window?.rootViewController == nil {
debugPrint("TSRouter: window.rootViewController is not find")
return nil
}
let rootVC: UIViewController = self.root
var topVC: UIViewController?
if rootVC is UITabBarController {
topVC = (rootVC as! UITabBarController).selectedViewController
if topVC is TSNavigationController {
if let vc = ((topVC as! TSNavigationController).visibleNavitionController) {
topVC = vc
}
}
} else if rootVC is UINavigationController {
topVC = rootVC
}
while ((topVC?.presentedViewController) != nil) {
topVC = (topVC?.presentedViewController)!
if topVC is TSNavigationController {
if let vc = ((topVC as! TSNavigationController).visibleNavitionController) {
topVC = vc
}
}
}
return topVC
}
TSRouter.shared.presentDestinationViewController = { (viewController) in
return TSNavigationController(rootViewController: viewController)
}
TSRouter.shared.transferTabbarViewController = {
if self.root is UITabBarController {
return self.root as? UITabBarController
}
return nil
}
TSRouter.shared.transferSpecialViewControllers = { (currentVC, path, parserDic) in
if path.contains("main") {
currentVC.navigationController?.popToRootViewController(animated: false)
if self.root is UITabBarController {
(self.root as! UITabBarController).selectedIndex = 0
}
}
if path .contains("customerService") {
// 根据自定义服务标识, 进行调度
}
}
TSRouter.shared.transferWebViewControllers = { (urlStr) in
let web = PBWebViewController()
web.htmlString = urlStr
TSRouter.routerPushVC(web)
}
TSRouter.shared.transferNeedRelySpecialStatus = { (vc) -> Bool in
if let token = PBUserInfo.shared.token, token.count > 0 {
return true
} else {
TSRouter.openUrl("hSchem://login")
return false
}
}
//这里可以随意定义
TSRouter.shared.scheme = "hSchem"
//这里需要指明本地译本所在,写plist名称即可
TSRouter.shared.moduleName = "moduleName"
}
另外,可被跳转的页面需要遵循协议并实现协议方法
extension ListDetailViewController : TSRouterProtocol {
func initWithRouter(routerData: [String : String]) {
if let itemId = routerData["itemId"] {
self.itemId = itemId
}
}
}
plist文件中我举了几个译本的例子,可供参考,其中的transferStyle意义在于控制页面跳转的动作,可查阅以下代码来看
public enum TSRouterTransferStyle: String {
case push = "push"
case present = "present"
case tabTransfer = "transferTab" //tabbar 切换
case specialTransfer = "specialTransfer" //特殊跳转
}
本地页面跳转需要明确如何跳转,所以在plist文件中可以设置4种动作
设置完成后,具体使用代码如下
//可以再需要跳转页面的地方调用如下代码
//跳转登陆页面
TSRouter.openUrl("hSchem://login")
//跳转详情页面并传入 itemId 参数 1
TSRouter.openUrl("hSchem://listDetail?itemId=1")
//跳转详情页面并传入 itemId 参数 1,pageId 参数 2
TSRouter.openUrl("hSchem://listDetail?itemId=1&pageId=2")
// 这里的参数如果替换成后台返回,就可以灵活配置跳转页面的动作了
总结一下使用方法
1、AppDelegate中要对工具进行配置
2、配置好本地译本,也就是plist文件,其中className要对应目标页面的类名,要配置跳转方式,tabber主页面需要指定transferStyle为 transferTab,需要特殊处理的可以标记为specialTransfer,然后在AppDelegate中自行处理跳转逻辑
3、参与跳转的ViewController需要实现TSRouterProtocol协议的initWithRouter方法,方法内可以接收入参
4、发起跳转调用方法
TSRouter.openUrl("***")