iOS URL跳转组件CCRouter

一、简介

CCRouter 是一个简单的iOS项目页面URL路由组件。它旨在使项目中处理复杂跳转变得简单。

CCRouter 可以很方便的处理不同 URL schemes 以及解析它们的参数，并通过回调 block 来处理 URL 对应的操作 , 是一个可以用于处理复杂跳转逻辑的三方库。

二、使用场景

1、在日常开发中，push、present 出现在整个程序的各个地方，如果你想快速理清一个项目的整体逻辑，那会非常麻烦。大多数情况 , 你得找到代码目录，根据层级结构分出关系，然后找到对应的push位置，寻找下一级页面，如果本身项目的目录就非常乱，那么如果要了解一个项目的整体跳转逻辑，将会更加困难。
如果能把整个项目的跳转逻辑都给抽取出来，单独放在一个类，模块化管理，那么思路就会清晰很多，甚至可以用 XMind 根据代码画出整个项目的树状图。
2、如果所处公司存在多个app，app之间互相推荐互相跳转是再正常不过的需求，就类似于QQ、微信、第三方分享跳转等。如果用Appdelegate 原生方法进行拦截，所做的事至少得是判断 Scheme 是否匹配，想办法进入需要跳到的界面，如果要涉及传参，就更加麻烦。
3、如果用户是从 PC端 识别二维码，或者通过链接想要进入 app 指定页面。

三、原理

本质

CCRouter 本质可以理解为：保存一个全局的字典，key 是 URL，value 是对应存放 block 的数组，URL 和 block 都会常驻在内存中，当打开一个 URL 时，CCRouter 就可以遍历这个全局的字典，通过 URL 来执行对应的 block。

- (void)registerBlock:(void (^)(NSDictionary * _Nonnull))routeHandleBlock forRoute:(NSString *)route {
    if (routeHandleBlock && route.length > 0) {
        [self.routes addObject:route];
        [self.blocksByRoute setObject:[routeHandleBlock copy] forKey:route];
    }
}

参数的解析

/**
 例如iOS://tasklist?title=任务列表&code=12
 */
- (CCRouterInfo *)routeInfo:(NSString *)fullRoute {
    CCRouterInfo *info = [[CCRouterInfo alloc] init];
    NSArray *fullParts = [fullRoute componentsSeparatedByString:@"://"];
    if (fullParts.count < 2) {
        return nil;
    }
    
    info.scheme = [fullParts firstObject];
    NSString *delimiter = @"?";
    NSArray *routePartArray = [fullRoute componentsSeparatedByString:delimiter];
    info.routePath = [routePartArray firstObject];
    if (routePartArray.count == 1) {
        info.routeParameter = @{};
        return info;
    }
    
    NSAssert(routePartArray.count > 1, @"带参Route必须包含“?”右侧参数");
    NSString *paramsString = [routePartArray objectAtIndex:1];
    delimiter = @"&";
    NSMutableDictionary *paramsDict = [NSMutableDictionary dictionary];
    NSArray *paramsPartArray = [paramsString componentsSeparatedByString:delimiter];
    delimiter = @"=";
    for (NSString *keyAndValue in paramsPartArray) {
        NSArray *keyValueArray = [keyAndValue componentsSeparatedByString:delimiter];
        NSAssert(keyValueArray.count == 2, @"参数key和value都不能为空");
        NSString *key = [keyValueArray firstObject];
        NSString *value = [keyValueArray lastObject];
        [paramsDict setObject:value forKey:key];
    }
    info.routeParameter = paramsDict;
    return info;
}

四、用法

1、pod 引入

pod 'CCRouter'

2、 注册
URL带参注册方式

[[CCRouter sharedInstance] registerBlock:^(NSDictionary *param) {
        FirstViewController *firstVC = [[FirstViewController alloc] init];
        firstVC.strTitle = param[@"title"];
        firstVC.strTips = param[@"tips"];
        UINavigationController *navc = [UIViewController currentViewController].navigationController;
        [navc pushViewController:firstVC animated:YES];
    } forRoute:@"ios://firstpage"];

单独传递参数注册方式

[[CCRouter sharedInstance] registerDictionaryParamBlock:^(NSDictionary *params) {
        SecondViewController *secondVC = [[SecondViewController alloc] init];
        secondVC.strTitle = params[@"title"];
        secondVC.strTips = params[@"tips"];
        UINavigationController *navc = [UIViewController currentViewController].navigationController;
        [navc pushViewController:secondVC animated:YES];
    } forRoute:@"ios://secondpage"];

3、调用
URL带参调用方式

[[CCRouter sharedInstance] handleRoute:@"ios://firstpage?title=url带参&tips=这是第二个参数"];

单独传递参数调用方式

NSDictionary *dict = @{
                           @"title":@"参数传递",
                           @"tips":@"这是第二个参数"
                           };
 [[CCRouter sharedInstance] handleRoute:@"ios://secondpage" parameter:dict];

支持iOS、H5、Flutter页面及外部APP的跳转

按照规定的URL规则（schame://xxx/xx?key1=value1&key2=value2）
schame:用来标识跳转的页面是iOS/H5/Flutter还是外部APP

- (BOOL)isDingTalkRouter:(NSString *)route {
    return [route hasPrefix:@"dingtalk"];
}

//是APP的本地页面
- (BOOL)isiOSRoute:(NSString *)route {
    return [route hasPrefix:@"iOS:"];
}

- (BOOL)isWebRoute:(NSString*)route {
    if ([route hasPrefix:@"http"]) {
        return YES;
    } else {
        return NO;
    }
}

- (BOOL)isFlutterRoute:(NSString *)route {
    return [route hasPrefix:@"flutter"];
}

GitHub地址