PS 感謝大家的關注,由于我本想開源4個庫入录,除了router, 另外三個分別是native dispatcher, web dispatcher 和 react dispatcher , 所以router 對native dispatcher 有了庫依賴洲炊,為了共同學習花盐,我把router單獨分離成pod慕嚷,再次感謝大家的關注,歡迎叫router更完善谐檀。best regards.
如何優(yōu)雅的實現(xiàn)界面跳轉 之 統(tǒng)跳協(xié)議 - DarwinNativeRouter
@author Jou Email Weibo or Github
預熱 - 我要解決的問題
首先我還是要推薦Gaosboy的這篇文章解耦神器 —— 統(tǒng)跳協(xié)議和Rewrite引擎
文章中,介紹了天貓app裁奇,基于文件配置和uri的頁面跳轉桐猬。這大大增加了app端的靈活性, 而這種實現(xiàn)很類似今天的前端或后端開發(fā)中的 靜態(tài)路由 和 動態(tài)路由協(xié)議刽肠。
除了天貓溃肪,在很多的客戶端架構的文章中,路由解耦的案例并不不少見音五,如攜程移動App架構優(yōu)化之旅
蘑菇街App的組件化之路
原生路由協(xié)議惫撰, 其實兩年前就有了類似的實現(xiàn)。比如900+Star的HHRouter躺涝,而作者是當時還在布丁動畫工作的Light厨钻。2015年我有幸見到本人,人很nice坚嗜,并真是全棧夯膀。
DarwinNativeRouter 在接口設計上,很大程度上的參考了現(xiàn)有的react路由協(xié)議 react router苍蔬。并且對原生跳轉方式保留很大的可擴展性诱建。所以我的初衷 DarwinNativeRouter 是一個足夠輕量級的框架。Light & Flexible碟绑。
全局路由協(xié)議能解決的問題
錯中復雜的Controller的跳轉依賴
在iOS的世界里俺猿,傳統(tǒng)的Controller跳轉方式, A 跳轉 B格仲, 則 A 必須持有 B 的對象押袍。 而在app長大的過程中, 勢必會造成 A -> B , B -> C, A -> C D, E, F...
從而產(chǎn)生復雜的依賴鏈凯肋。全局的Router 使 A 不必依賴于 特定的 Controller 便可以實現(xiàn)跳轉伯病。
如下面跳轉:
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"];
推送通知,點擊打開指定頁面
對于這種需求, 相信午笛,目前最多的實現(xiàn)應該是兩種惭蟋, 一種的傳參的Url, 而另一種药磺,是傳遞int類型告组,并通過類似switch case對參數(shù)值的硬編碼,實現(xiàn)跳轉邏輯癌佩。
我是很反感第二種的跳轉方式木缝, 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稿湿, 在點擊對應的新浪微博熱點 條目時铅匹, 就發(fā)生了跳轉,并跳到了條目詳情饺藤。
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 特性
靜態(tài)路由 /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.
}];
動態(tài)路由 /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 現(xiàn)在還沒有到1.0版本比原,還有很多可以想象的東西,歡迎讓他更加完善杠巡,和提pr量窘。
DarwinNativeRouter's Github