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:
UIViewController *personal = [UIViewController new];
personal.userId = @"10238372";
[self.navigationController pushViewController:personal animated:YES];
Router Code:
[[DNRouter router]open:@"./user/10238372/profile"];
又比如我们要在navigationController根路径跳转
We Always Do:
[self.navigationController popToRootViewControllerAnimated:NO];
UIViewController *personal = [UIViewController new];
personal.userId = @"10238372";
[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:
switch (type) {
case 1001:
//jumping code
break;
case 1002:
//jumping code
break;
case 1003:
//jumping code
break;
case 1004:
//jumping code
break;
default:
break;
}
Now we need do:
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
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options
{
if([[DNRouter router]canOpen:url.absoluteString])
{
[[DNRouter router]open:url.absoluteString];
return YES;
}
return NO;
}
一致的行为处理, Hybrid & React Native
有了Router, 你可以使这些跳转 有一致的行为。
DarwinNativeRouter 特性
静态路由 /user
[DNRouter routerWithName:@"profile" path:@"/user"
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(NO).pushViewController(controller);
// 希望大家注意下动画的设置,若animation设为YES, 容易造成animation system的混乱,需要保证最后一个push的前的所有controller的动画为NO.
}];
动态路由 /user/:id
[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(NO).pushViewController(controller);
// 希望大家注意下动画的设置,若animation设为YES, 容易造成animation system的混乱,需要保证最后一个push的前的所有controller的动画为NO.
}];
更方便的跳转,名称跳转 name jumping
[[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
网友评论