feat(All): 支持单页面多路由

Author: wxlpp

Example/Podfile

@@ -1,6 +1,9 @@
 platform :ios, '9.0'
 inhibit_all_warnings!
-install! 'cocoapods', :generate_multiple_pod_projects => true, :incremental_installation => true
+install! 'cocoapods',
+:generate_multiple_pod_projects => true,
+:incremental_installation => true,
+:warn_for_unused_master_specs_repo => false
 
 target 'shell' do
   use_frameworks!

Example/Podfile.lock

@@ -17,6 +17,6 @@ SPEC CHECKSUMS:
   Submodule: 4d6c30b294c43d33503985e348909fd7c4c02353
   UIRouter: cc1486c13af569df95ed9a6c0dfb0b8e5532ec65
 
-PODFILE CHECKSUM: 6cbdf15ab32343a1b20c502fe96b51208e44cc80
+PODFILE CHECKSUM: ba24c8ebfe1e7f5e3aea87b3cd76d9bb52a9c99e
 
 COCOAPODS: 1.10.1

Example/Submodule/Source/SubViewController.swift

@@ -27,7 +27,7 @@ extension SubViewController: Routable {
         completion(.success(SubViewController()))
     }
 
-    public static var path: String {
-        "sub"
+    public static var paths: [String] {
+        ["sub"]
     }
 }

Example/Submodule/UserProfileViewController.swift

@@ -13,15 +13,15 @@ public final class UserProfileViewController: UIViewController {}
 // MARK: 路由
 
 extension UserProfileViewController: Routable {
+    public static var paths: [String] {
+        ["user/profile/:id"]
+    }
+    
     public static func route(parameters: RouterParameters, completion: @escaping RouteCompletionHandler<UserProfileViewController>) {
         if let userID: String = parameters.get("userID") {
             completion(.success(UserProfileViewController()))
         } else {
-            completion(.failure(RouteError.parameterValidationFailed(url: path, name: "userID")))
+            completion(.failure(RouteError.parameterValidationFailed(vcType: Self.self, name: "userID")))
         }
     }
-
-    public static var path: String {
-        "user/profile/:id"
-    }
 }

Example/shell/MainViewController.swift

@@ -32,6 +32,5 @@ class MainViewController: UITableViewController {
     override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
         tableView.deselectRow(at: indexPath, animated: true)
         UIApplication.shared.route(url: routes[indexPath.row].path).push()
-        UIApplication.shared.route(url: routes[indexPath.row].path).presentWithNavigationController(UINavigationController.self)
     }
 }

Routable.swift

@@ -0,0 +1,32 @@
+//
+//  Routable.swift
+//  UIRouter
+//
+//  Created by wxlpp on 2021/5/3.
+// Copyright © 2021 Wang Xiaolong. All rights reserved.
+//
+
+import UIKit
+
+public protocol RouteBase: UIViewController {
+    static var paths: [String] { get }
+    static func routeVC(parameters: RouterParameters, completion: @escaping RouteCompletionHandler<UIViewController>)
+}
+
+/// 需要通过路由解耦的 `UIViewController` 实现此协议后,路由中心将会自动完成组件的注册
+public protocol Routable: RouteBase {
+
+    /// 路由中心通过路由链接到指定 `UIViewController` 后由此回调进行页面构造
+    /// - Parameters:
+    ///   - parameters: 由路由 `URL` 解析后传递的参数
+    ///   - completion: 验证参数后构造页面通过回调返回结果
+    static func route(parameters: RouterParameters, completion: @escaping RouteCompletionHandler<Self>)
+}
+
+public extension Routable {
+    static func routeVC(parameters: RouterParameters, completion: @escaping RouteCompletionHandler<UIViewController>) {
+        route(parameters: parameters) { result in
+            completion(result.map { $0 as UIViewController })
+        }
+    }
+}

Source/RouteError.swift

@@ -5,7 +5,7 @@
 //  Created by wxlpp on 2021/5/1.
 //
 
-import Foundation
+import UIKit
 
 /// 路由错误
 public enum RouteError {
@@ -16,7 +16,7 @@ public enum RouteError {
     /// 路由终点页面未注册
     case routeDoesNotExist(url: String)
     /// 参数验证失败
-    case parameterValidationFailed(url: String, name: String)
+    case parameterValidationFailed(vcType: UIViewController.Type, name: String)
 }
 
 // MARK: - LocalizedError
@@ -32,8 +32,8 @@ extension RouteError: LocalizedError {
                 return "路由失败 路径[\(url)]"
             case .routeDoesNotExist(url: let url):
                 return "路由失败 路径[\(url)]"
-            case .parameterValidationFailed(url: let url, name: let name):
-                return "路由参数验证失败 路径[\(url)] 参数[\(name)]"
+            case .parameterValidationFailed(vcType: let type, name: let name):
+                return "路由参数验证失败 页面[\(type)] 参数[\(name)]"
         }
     }
 
@@ -46,7 +46,7 @@ extension RouteError: LocalizedError {
                 return "尝试注册路由但地址已存在"
             case .routeDoesNotExist:
                 return "路由终点页面未注册"
-        case .parameterValidationFailed(url: _, name: let name):
+        case .parameterValidationFailed(vcType: _, name: let name):
                 return "未能获取参数[\(name)]"
         }
     }

Source/Router.swift Source/UIViewControllerRouter.swiftSource/Router.swift renamed to Source/UIViewControllerRouter.swift

@@ -1,36 +1,12 @@
 //
-// Router.swift
+// UIViewControllerRouter.swift
 //
 // Created by wxlpp on 2021/5/1.
 // Copyright © 2021 Wang Xiaolong. All rights reserved.
 //
 
 import UIKit
 
-public protocol RouteBase: UIViewController {
-    static var path: String { get }
-    static func routeVC(parameters: RouterParameters, completion: @escaping RouteCompletionHandler<UIViewController>)
-}
-
-/// 需要通过路由解耦的 `UIViewController` 实现此协议后,路由中心将会自动完成组件的注册
-public protocol Routable: RouteBase {
-
-    /// 路由中心通过路由链接到指定 `UIViewController` 后由此回调进行页面构造
-    /// - Parameters:
-    ///   - parameters: 由路由 `URL` 解析后传递的参数
-    ///   - completion: 验证参数后构造页面通过回调返回结果
-    static func route(parameters: RouterParameters, completion: @escaping RouteCompletionHandler<Self>)
-}
-
-public extension Routable {
-    static func routeVC(parameters: RouterParameters, completion: @escaping RouteCompletionHandler<UIViewController>) {
-        route(parameters: parameters) { result in
-            completion(result.map { $0 as UIViewController })
-        }
-    }
-}
-
-
 /// 一个路由器可以通过解析链接获得一个指定的`UIViewController`实例
 public class UIViewControllerRouter {
     private var isInitialized = false
@@ -91,8 +67,10 @@ public class UIViewControllerRouter {
             for i in 0 ..< numberOfClasses {
                 let item: AnyClass = classesPtr[i]
                 if let vcType = item as? RouteBase.Type {
-                    try? urlRouter.register(route: vcType.path) { parameters, completion in
-                        vcType.routeVC(parameters: parameters, completion: completion)
+                    for path in vcType.paths {
+                        try? urlRouter.register(route: path) { parameters, completion in
+                            vcType.routeVC(parameters: parameters, completion: completion)
+                        }
                     }
                 }
             }