JLRoutes是一個(gè)調(diào)用極少代碼 , 可以很方便的處理不同URL schemes以及解析它們的參數(shù)，并通過回調(diào)block來處理URL對(duì)應(yīng)的操作 , 可以用于處理復(fù)雜跳轉(zhuǎn)邏輯的三方庫.

1.在日常開發(fā)中 , push , present 出現(xiàn)在整個(gè)程序的各個(gè)地方 , 如果你想快速理清一個(gè)項(xiàng)目的整體邏輯 , 非常麻煩 . 大多數(shù)情況 , 你得找到代碼目錄 ,根據(jù)層級(jí)結(jié)構(gòu)分出關(guān)系 , 然后找到對(duì)應(yīng)的push位置 , 尋找下一級(jí)頁面 , 如果本身項(xiàng)目的目錄就非常亂 , 那么如果要了解一個(gè)項(xiàng)目的整體跳轉(zhuǎn)邏輯 , 非常的難.

即便可以將 UIViewController-Swizzled 庫集成到項(xiàng)目中 ,然后一頁一頁點(diǎn)擊查詢 , 但也是比較痛苦的.

如果 , 是把整個(gè)項(xiàng)目的跳轉(zhuǎn)邏輯都給抽取出來 , 單獨(dú)放在一個(gè)類 , 模塊化管理 , 那么思路就會(huì)清晰很多 , 甚至可以用XMind根據(jù)代碼畫出整個(gè)項(xiàng)目的樹狀圖

2.如果所處公司存在多個(gè)app , app之間互相推薦 , 互相跳轉(zhuǎn)是再正常不過的需求,就類似于QQ , 微信三方分享跳轉(zhuǎn)等 .如果用Appdelegate原生方法進(jìn)行攔截 , 所做的事至少得是判斷Scheme是否匹配 , 想辦法進(jìn)入需要跳到的界面 , 如果要涉及傳參 , 就更加麻煩.

3. 如果用戶是從PC端識(shí)別二維碼,或者通過鏈接想要進(jìn)入app指定頁面

基于 JLRoute 實(shí)現(xiàn)的模塊化示例，包括鏈接跳轉(zhuǎn)原生頁面、WebView頁面和ReactNative頁面

模塊化已經(jīng)成為調(diào)劑龐大項(xiàng)目結(jié)構(gòu)的一劑良藥，對(duì)項(xiàng)目的開發(fā)、維護(hù)和后續(xù)的擴(kuò)展的好處已經(jīng)不言而喻。

要求

1. iOS 8.0+
2. Xcode 7.0+

安裝方法

安裝

在 iOS, 你需要在 Podfile 中添加.

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!

pod 'JLRoutes', '~> 2.0.1'

# 'node_modules'目錄一般位于根目錄中
# 但是如果你的結(jié)構(gòu)不同，那你就要根據(jù)實(shí)際路徑修改下面的`:path`
pod 'React', :path => './node_modules/react-native', :subspecs => [
  'Core',
  'RCTText',
  'RCTNetwork',
  'RCTWebSocket', # 這個(gè)模塊是用于調(diào)試功能的
  # 在這里繼續(xù)添加你所需要的模塊
]
# 如果你的RN版本 >= 0.42.0，請(qǐng)加入下面這行
pod "Yoga", :path => "./node_modules/react-native/ReactCommon/yoga"

啟動(dòng) ReactNative 環(huán)境

1.修改項(xiàng)目ModuleARNPageViewController.m IP 跳轉(zhuǎn)地址

2.進(jìn)入項(xiàng)目所在目錄，運(yùn)行

npm start

JLRoutes的工作流程和原理

單一的Scheme注冊(cè)過程：

1.調(diào)用注冊(cè)方法（用戶注冊(cè)routePattern，默認(rèn)優(yōu)先級(jí)0）

2.路由解析（這些解析跟我們?cè)O(shè)置路由的規(guī)則有直接關(guān)系）

(1)判斷接口URL是否設(shè)置可選性URL并將對(duì)應(yīng)的URL封裝成JLRRouteDefinition對(duì)象

(2)將JLRRouteDefinition對(duì)象裝載進(jìn)一個(gè)可變數(shù)組，內(nèi)存保留了所有的對(duì)象?。?/p>

（JLRRouteDefinition對(duì)象包括有路徑，參數(shù)解析，block等信息）

單一的Scheme調(diào)用過程：

1.調(diào)用URL

+ (BOOL)routeURL:(NSURL *)URL

2.解析URL，將參數(shù)，路由信息封裝成JLRRouteRequest對(duì)象

3.給JLrouteRequest對(duì)象和路由數(shù)組里的JLRRouteDefinition對(duì)象作比對(duì)，并且返回JLRRouteResponse 對(duì)象抽出參數(shù)和URL在數(shù)組里

4.調(diào)用JLRRouteResponse 對(duì)象里面的回調(diào)方法

[route callHandlerBlockWithParameters:finalParameters];

JLRoutes的URL注冊(cè)規(guī)則：

1.普通注冊(cè)

JLRoutes *routes = [JLRoutes globalRoutes];
[routes addRoute:@"/user/view/:userID" handler:^BOOL(NSDictionary *parameters) {
NSString *userID = parameters[@"userID"]; // defined in the route by specifying ":userID"
// present UI for viewing user with ID 'userID'
return YES; // return YES to say we have handled the route
}];

URL里，分號(hào)表示這個(gè)是參數(shù)

另外一種注冊(cè)方式，下標(biāo)注冊(cè)法

JLRoutes.globalRoutes[@"/route/:param"] = ^BOOL(NSDictionary *parameters) {
// ...
};

如何按照以上的方式注冊(cè)，在任何時(shí)刻（包括在其它的APP）你都可以調(diào)用這個(gè)URL。

NSURL *viewUserURL = [NSURL URLWithString:@"myapp://user/view/joeldev"];
[[UIApplication sharedApplication] openURL:viewUserURL];

在這個(gè)例子中，在parmameters字典里面的userID會(huì)傳給block，它是一個(gè)鍵值對(duì)?！眜serID”: “joeldev”。給UI層或者任何需要它的地方用的。

字典參數(shù)：

字典參數(shù)總包括至少一下3個(gè)鍵：

{
"JLRouteURL": "(the NSURL that caused this block to be fired)",
"JLRoutePattern": "(the actual route pattern string)",
"JLRouteScheme": "(the route scheme, defaults to JLRoutesGlobalRoutesScheme)"
}

處理Block

你會(huì)發(fā)現(xiàn)，每個(gè)注冊(cè)的block都會(huì)返回一個(gè)YES。這個(gè)值，如果你返回NO，JLRoutes會(huì)跳過這個(gè)匹配，然后繼續(xù)去匹配其它的。

如果你的block設(shè)置成nil，它會(huì)默認(rèn)返回YES。

2.復(fù)雜注冊(cè)

[[JLRoutes globalRoutes] addRoute:@"/:object/:action/:primaryKey" handler:^BOOL(NSDictionary *parameters) {
NSString *object = parameters[@"object"];
NSString *action = parameters[@"action"];
NSString *primaryKey = parameters[@"primaryKey"];
// stuff
return YES;
}];

這個(gè)地址會(huì)被匹配很多URL，如/user/view/joeldev or /post/edit/123。這些URL上的是參數(shù)。

NSURL *editPost = [NSURL URLWithString:@"myapp://post/edit/123?debug=true&foo=bar"];
[[UIApplication sharedApplication] openURL:editPost];

這時(shí)，pramater字典就會(huì)是以下這樣的（傳參）

{
"object": "post",
"action": "edit",
"primaryKey": "123",
"debug": "true",
"foo": "bar",
"JLRouteURL": "myapp://post/edit/123?debug=true&foo=bar",
"JLRoutePattern": "/:object/:action/:primaryKey",
"JLRouteScheme": "JLRoutesGlobalRoutesScheme"
}

3.Scheme（有沒有多態(tài)的感覺）

JLRoutes支持用指定的URL scheme來創(chuàng)建路由。相同的scheme才能被匹配。默認(rèn)地，所有的URL會(huì)設(shè)置進(jìn)global scheme。

[[JLRoutes globalRoutes] addRoute:@"/foo" handler:^BOOL(NSDictionary *parameters) {
// This block is called if the scheme is not 'thing' or 'stuff' (see below)
return YES;
}];
[[JLRoutes routesForScheme:@"thing"] addRoute:@"/foo" handler:^BOOL(NSDictionary *parameters) {
// This block is called for thing://foo
return YES;
}];
[[JLRoutes routesForScheme:@"stuff"] addRoute:@"/foo" handler:^BOOL(NSDictionary *parameters) {
// This block is called for stuff://foo
return YES;
}];
如果你調(diào)用的使用，是這樣調(diào)用的

[[JLRoutes globalRoutes] addRoute:@"/global" handler:^BOOL(NSDictionary *parameters) {
return YES;
}];

它只會(huì)調(diào)用global scheme的對(duì)應(yīng)的URL。不會(huì)調(diào)用ting scheme里面對(duì)應(yīng)的URL。

當(dāng)然，你可以設(shè)置，如果指定的scheme沒有這個(gè)URL，去查詢global scheme 有沒有。你需要設(shè)置一個(gè)屬性。

[JLRoutes routesForScheme:@"thing"].shouldFallbackToGlobalRoutes = YES;

3.通配符的設(shè)置URL的方式

通配符為：*

通配符符后面所有的URL上的參數(shù)都會(huì)以一個(gè)數(shù)組保存在parameters字典里面的JLRouteWildcardComponentsKey對(duì)應(yīng)的value里。

例如，如果你注冊(cè)URL如下:

[[JLRoutes globalRoutes] addRoute:@"/wildcard/*" handler:^BOOL(NSDictionary *parameters) {
NSArray *pathComponents = parameters[JLRouteWildcardComponentsKey];
if ([pathComponents count] > 0 && [pathComponents[0] isEqualToString:@"joker"]) {
// the route matched; do stuff
return YES;
}
// not interested unless the joker's in it
return NO;
}];

如果調(diào)用的URL開始是／wildcard，這個(gè)路由就可能被觸發(fā)！！如果第一個(gè)參數(shù)是joker，就被觸發(fā)，如果不是，就被拒絕觸發(fā)。。。

4.選擇性路由

如果路由地址設(shè)置樣式有括號(hào)，如：/the(/foo/:a)(/bar/:b)，其實(shí)它代表的URL有如下：

/the/foo/:a/bar/:b
/the/foo/:a
/the/bar/:b
/the

5.查詢 Routes

下面的方式，你可以查看Routes里所有注冊(cè)的URL Routes。

/// All registered routes, keyed by scheme
+ (NSDictionary <NSString *, NSArray <JLRRouteDefinition *> *> *)allRoutes;
/// Return all registered routes in the receiving scheme namespace.
- (NSArray <JLRRouteDefinition *> *)routes;

自定義路由解析 如果你想自己定制一個(gè)路由編輯，你可以繼承JLRouteDefinition并且用 addRoute：方法去添加你自定義類的對(duì)象。

以上就是本文的全部內(nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論