預熱 – 我要解決的問題
首先我還是要推薦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 2 3 |
UIViewController *personal = [UIViewController new]; personal.userId = @"10238372"; [self.navigationController pushViewController:personal animated:YES]; |
Router Code:
1 |
[[DNRouter router]open:@"./user/10238372/profile"]; |
又比如我們要在navigationController根路徑跳轉
We Always Do:
1 2 3 4 |
[self.navigationController popToRootViewControllerAnimated:NO]; UIViewController *personal = [UIViewController new]; personal.userId = @"10238372"; [self.navigationController pushViewController:personal animated:YES]; |
Router Code:
1 |
[[DNRouter router]open:@"/user/10238372/profile"]; |
推送通知,點選開啟指定頁面
對於這種需求, 相信,目前最多的實現應該是兩種, 一種的傳參的Url, 而另一種,是傳遞int型別,並通過類似switch case對引數值的硬編碼,實現跳轉邏輯。
我是很反感第二種的跳轉方式, 1. int毫無疑義, 只能硬解釋。 2. 跳轉的頁面有限。 當然如果url採用硬編碼, 也是跳轉有限的。
而有了router,一切不一樣。
- 從didFinishLaunchingWithOptions 和 didReceiveRemoteNotification捕獲payload
- 跳用Router
Somethings we may do:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
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:
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 2 3 4 5 6 7 8 9 |
- (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
1 2 3 4 5 6 7 8 9 10 11 12 |
[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(YES).pushViewController(controller); }]; |
動態路由 /user/:id
1 2 3 4 5 6 7 8 9 10 11 12 |
[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); }]; |
更方便的跳轉,名稱跳轉 name jumping
1 |
[[DNRouter router]redirect:@"profile"]; |
相對路徑跳轉
1 2 3 4 5 6 7 8 |
//跟路徑 [[DNRouter router]open:@"/user"]; //當前路徑 [[DNRouter router]open:@"./user"]; //上一級 [[DNRouter router]open:@"../user"]; |
易擴充套件, 自定義跳轉 action
1 2 3 4 5 6 7 8 9 10 11 12 |
[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
1 2 3 4 5 6 7 8 9 10 11 12 13 |
// 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