PS 感谢大家的关注,由于我本想开源4个库,除了router, 另外三个分别是native dispatcher, web dispatcher 和 react dispatcher , 所以router 对native dispatcher 有了库依赖,为了共同学习,我把router单独分离成pod,再次感谢大家的关注,欢迎叫router更完善。best regards.
如何优雅的实现界面跳转 之 统跳协议 - DarwinNativeRouter
@author Jou Email Weibo or Github
预热 - 我要解决的问题
首先我还是要推荐Gaosboy的这篇文章解耦神器 —— 统跳协议和Rewrite引擎
文章中,介绍了天猫app,基于文件配置和uri的页面跳转。这大大增加了app端的灵活性, 而这种实现很类似今天的前端或后端开发中的 静态路由 和 动态路由协议。
除了天猫,在很多的客户端架构的文章中,路由解耦的案例并不不少见,如携程移动App架构优化之旅
蘑菇街App的组件化之路
原生路由协议, 其实两年前就有了类似的实现。比如900+Star的HHRouter,而作者是当时还在布丁动画工作的Light。2015年我有幸见到本人,人很nice,并真是全栈。
DarwinNativeRouter 在接口设计上,很大程度上的参考了现有的react路由协议 react router。并且对原生跳转方式保留很大的可扩展性。所以我的初衷 DarwinNativeRouter 是一个足够轻量级的框架。Light & Flexible。
全局路由协议能解决的问题
错中复杂的Controller的跳转依赖
在iOS的世界里,传统的Controller跳转方式, A 跳转 B, 则 A 必须持有 B 的对象。 而在app长大的过程中, 势必会造成 A -> B , B -> C, A -> C D, E, F...
从而产生复杂的依赖链。全局的Router 使 A 不必依赖于 特定的 Controller 便可以实现跳转。
如下面跳转:
We Always Do:
1 UIViewController *personal = [UIViewController new]; 2 personal.userId = @"10238372"; 3 [self.navigationController pushViewController:personal animated:YES];
Router Code:
1 [[DNRouter router]open:@"./user/10238372/profile"]; 又比如我们要在navigationController根路径跳转
We Always Do:
1 [self.navigationController popToRootViewControllerAnimated:NO]; 2 UIViewController *personal = [UIViewController new]; 3 personal.userId = @"10238372"; 4 [self.navigationController pushViewController:personal animated:YES];
Router Code:
[[DNRouter router]open:@"/user/10238372/profile"];
推送通知,点击打开指定页面
对于这种需求, 相信,目前最多的实现应该是两种, 一种的传参的Url, 而另一种,是传递int类型,并通过类似switch case对参数值的硬编码,实现跳转逻辑。
我是很反感第二种的跳转方式, 1. int毫无疑义, 只能硬解释。 2. 跳转的页面有限。 当然如果url采用硬编码, 也是跳转有限的。
而有了router,一切不一样。
- 从didFinishLaunchingWithOptions 和 didReceiveRemoteNotification捕获payload
- 跳用Router
Somethings we may do:
1 switch (type) { 2 case 1001: 3 //jumping code 4 break; 5 6 case 1002: 7 //jumping code 8 break; 9 case 1003: 10 //jumping code 11 break; 12 case 1004: 13 //jumping code 14 break; 15 16 default: 17 break; 18 }
Now we need do:
1 if([[DNRouter router]canOpen:url.absoluteString]) [[DNRouter router]open:url.absoluteString]; app间通讯 及 deeplink
Router 可以轻松handle deeplink。 deeplink 即: 从safari打开app的指定页面。 这方面做得比较好的, 如新浪微博的app, 在点击对应的新浪微博热点 条目时, 就发生了跳转,并跳到了条目详情。
Router, 同样可以被用作 app 间通讯, 和 deeplink 的原理相同。uri的通讯方式,被认为是最简单的app间通讯。 如我们常常使用的微信分享,配置的 scheme 就是用来做跳转和通讯的。
Router Code
1 - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options 2 { 3 if([[DNRouter router]canOpen:url.absoluteString]) 4 { 5 [[DNRouter router]open:url.absoluteString]; 6 return YES; 7 } 8 return NO; 9 }
一致的行为处理, Hybrid & React Native
有了Router, 你可以使这些跳转 有一致的行为。
DarwinNativeRouter 特性
静态路由 /user
1 [DNRouter routerWithName:@"profile" path:@"/user" 2 navigationController:(UINavigationController *)self.window.rootViewController 3 controller:^__kindof UIViewController *{ 4 5 UIViewController *controller = [[UIStoryboard storyboardWithName:@"Main" bundle:nil]instantiateViewControllerWithIdentifier:@"kMainBoard"]; 6 return controller; 7 8 } action:^(__kindof UIViewController *controller) { 9 10 [DNDispatcher dispatcher].defaultNavigationController.animation(NO).pushViewController(controller); 11 // 希望大家注意下动画的设置,若animation设为YES, 容易造成animation system的混乱,需要保证最后一个push的前的所有controller的动画为NO. 12 13 }];
动态路由 /user/:id
1 [DNRouter routerWithName:@"profile" path:@"/user/:id" 2 navigationController:(UINavigationController *)self.window.rootViewController 3 controller:^__kindof UIViewController *{ 4 5 UIViewController *controller = [[UIStoryboard storyboardWithName:@"Main" bundle:nil]instantiateViewControllerWithIdentifier:@"kMainBoard"]; 6 return controller; 7 8 } action:^(__kindof UIViewController *controller) { 9 10 [DNDispatcher dispatcher].defaultNavigationController.animation(NO).pushViewController(controller); 11 // 希望大家注意下动画的设置,若animation设为YES, 容易造成animation system的混乱,需要保证最后一个push的前的所有controller的动画为NO. 12 }];
更方便的跳转,名称跳转 name jumping
1 [[DNRouter router]redirect:@"profile"]; 相对路径跳转
//跟路径 [[DNRouter router]open:@"/user"]; //当前路径 [[DNRouter router]open:@"./user"]; //上一级 [[DNRouter router]open:@"../user"];
易扩展, 自定义跳转 action
[DNRouter routerWithName:@"profile" path:@"/user/:id" navigationController:(UINavigationController *)self.window.rootViewController controller:^__kindof UIViewController *{ UIViewController *controller = [[UIStoryboard storyboardWithName:@"Main" bundle:nil]instantiateViewControllerWithIdentifier:@"kMainBoard"]; return controller; } action:^(__kindof UIViewController *controller) { [DNDispatcher dispatcher].defaultNavigationController.animation(YES).pushViewController(controller); }];
默认行为,及 异常处理,index & 404
// index page [DNRouter defaultRouterWithController:^__kindof UIViewController *{ } action:^(__kindof UIViewController *controller) { }]; // 404 page [DNRouter notFoundRouterWithController:^__kindof UIViewController *{ } action:^(__kindof UIViewController *controller) { }];
后言
DarwinNativeRouter 现在还没有到1.0版本,还有很多可以想象的东西,欢迎让他更加完善,和提pr。
DarwinNativeRouter‘s Github
@author Jou Email Weibo or Github