转载

[译]iOS App 上一种灵活的路由方式

[译]iOS App 上一种灵活的路由方式

“Trollstigen”

Rosberry 中我们已经放弃使用除了 Launch Screen 以外的所有 storyboard,当然,所有布局和跳转逻辑都在代码里进行配置。如果想要进一步了解,请参考我们团队的这篇文章 没有 Interface Builder 的生活,我希望你会觉得这篇文章非常实用。

在这篇文章里,我将会介绍一种在 View Controller 之间的新的路由方式。我们将带着问题开始,然后一步一步地走向最终结论。享受阅读吧!

深入挖掘这个问题

让我们使用一个具体的例子来理解这个问题。例如我们准备做一个 App,它包含了个人主页、好友列表、聊天窗口等组成部分。很显然,我们可以注意到在很多 Controller 里都需要通过页面跳转去显示用户的个主页,如果这个逻辑只实现一次,并且能复用的话,那就非常好了。我们记得 DRY

我们无法使用一些 storyboard 来实现它,你可以想象一下,它在 storyboard 里面看起像什么——weeeeb 页面. 

现在我们使用的是 MVVM + Router 的架构,由 ViewModel 告诉 Router 需要跳转到一个其他的模块,然后 router 去执行。在我们的例子中,为了避免 view controller(或者View model)臃肿,Router 仅仅携带了所有的跳转逻辑。如果你一开始不是很明白,不用担心!我将会用一种比较浅显的方式来解释这种解决方案,所以它也会很容易地被应用到简单的 MVC 中去。

解决方案

1. 一开始,添加一个拓展到 ViewController 看起来像是一个毫无异议的解决方案:

extension UIViewController {
    func openProfile(for user: User) {
        let profileViewController = ProfileViewController(user: user)
        present(profileViewController, animated: true, completion: nil)
    }
}

这就是我们想要的——一次编写,多次使用。但是当有很多页面跳转的时候,它会变得很凌乱。我知道 Xcode 的自动补全不好用,但是有时候会给显示很多不需要的方法。即使你不想要在这一页面显示一个个人主页,它还是会存在于那里。所以试着更进一步去优化它。

2. 不要在 ViewControlelr 里写一个扩展,然后在一个地方写大量方法,让我们在一个单独的协议中实现每一个路由,然后使用 Swift 的一个非常好的特性?——?协议扩展。

protocol ProfileRoute {
    func openProfile(for user: User)
}
extension ProfileRoute where Self: UIViewController {
    func openProfile(for user: User) {
        let profileViewController = ProfileViewController(user: user)
        present(profileViewController, animated: true, completion: nil)
    }
}
f

现在这个方法就比较灵活了——我们可以扩展一个控制器,仅添加那些所需要的路由(避免写大量的方法),只是添加一个路由到控制器的继承体系里。

3. 但是,理所当然地这里还有一些改进方式:

  • 如果我们想要从所有地方跳转到个人主页,除了一个地方以外(这很罕见,但有可能)呢?

  • 或者更严重的情况?——?如果我改变了跳转的进入方式,那么我也应该改变跳转页消失的方式( present / dismiss )。

我们现在没有机会去配置它,所以现在是时候使用少量的代码去实现一个抽象跳转——ModalTransition 和 PushTransition

protocol Transition: class {
    weak var viewController: UIViewController? { get set }
    func open(_ viewController: UIViewController)
    func close(_ viewController: UIViewController)
}

为了排版简化,下面我少写了一些 ModalTransition 的实现逻辑代码。Github 上有完整能用的版本。

class ModalTransition: NSObject {
    var animator: Animator?
    weak var viewController: UIViewController?
    init(animator: Animator? = nil) {
        self.animator = animator
    }
}
extension ModalTransition: Transition {}
extension ModalTransition: UIViewControllerTransitioningDelegate {}

下面同样减少了部分 PushTransition 的代码逻辑:

class PushTransition: NSObject {
    var animator: Animator?
    weak var viewController: UIViewController?
    init(animator: Animator? = nil) {
        self.animator = animator
    }
}
extension PushTransition: Transition {}
extension PushTransition: UINavigationControllerDelegate {}

你一定注意到了 Animator 这个对象,它是一个简单的用于自定义跳转的协议:

protocol Animator: UIViewControllerAnimatedTransitioning {
    var isPresenting: Bool { get set }
}

正如我之前所说到的臃肿的 view controller,现在让我们添加一个包含整个路由逻辑的对象,然后让他作为 controller 的一个属性。这就是我们所实现的路由——一个未来可以被所有路由继承的基类。

protocol Closable: class {
    func close()
}
protocol RouterProtocol: class {
    associatedtype V: UIViewController
    weak var viewController: V? { get }
    
    func open(_ viewController: UIViewController, transition: Transition)
}
class Router: RouterProtocol, Closable where U: UIViewController {
    typealias V = U
    
    weak var viewController: V?
    var openTransition: Transition?
    func open(_ viewController: UIViewController, transition: Transition) {
        transition.viewController = self.viewController
        transition.open(viewController)
    }
    func close() {
        guard let openTransition = openTransition else {
            assertionFailure("You should specify an open transition in order to close a module.")
            return
        }
        guard let viewController = viewController else {
            assertionFailure("Nothing to close.")
            return
        }
        openTransition.close(viewController)
    }
}

请稍微花点时间去理解上面这些代码,这个类包含两个用于页面的打开和关闭的方法、一个 view controller 的引用和一个 openTransition 对象来让我们知道如何关闭这个模块。

现在让我们使用这个新的类来更新我们的 ProfileRoute

protocol ProfileRoute {
    var profileTransition: Transition { get }
    func openProfile(for user: User)
}
extension ProfileRoute where Self: RouterProtocol {
    var profileTransition: Transition {
        return ModalTransition()
    }
    func openProfile(for user: User) {
        let router = ProfileRouter()
        let profileViewController = ProfileViewController(router: router)
        router.viewController = profileViewController
        let transition = profileTransition // 这是一个已经计算过的属性,为了获取一个实例,我把它存为一个变量
        router.openTransition = transition
        open(profileViewController, transition: transition)
    }
}

你可以看到默认的界面的跳转是模态的,在 openProfile 方法中我们生成一个新的模块,然后打开它(当然如果使用建造者模式或者工厂模式来生成会更好)。同时注意一个变量 transition,为了拥有一个实例,profileTransition 会被保存到这个变量里。

下一步是更新 Friends 模块:

final class FriendsRouter: Router, FriendsRouter.Routes  {
    typealias Routes = ProfileRoute & /* other routes */ 
}
final class FriendsViewController: UIViewController {
    private let router: FriendsRouter.Routes
    init(router: FriendsRouter.Routes) {
        self.router = router
        super.init(nibName: nil, bundle: nil)
    }
  
    func userButtonPressed() {
        router.openProfile(for: /* some user */)
    }
}

我们已经创建了 FriendsRouter ,并且通过 typealias 添加了所需要的路由。这正是魔术发生的地方!我们使用协议组成(&)去添加更多路由和协议扩展,以此来使用一个默认的路由实现。

这篇文章的最后一步是简单友好的实现关闭跳转。如果你重新调用  ProfileRouter,那边我们实现已经配置好了 openTransition,那么现在就可以利用它。

我创建了一个 Profile 模块,它只有一个路由——关闭,而且当一个用户点击了关闭按钮,我们使用一样的跳转方式去关闭这个模块。

final class ProfileRouter: Router {
    typealias Routes = Closable
}
final class ProfileViewController: UIViewController {
    private let router: ProfileRouter.Routes
    init(router: ProfileRouter.Routes) {
        self.router = router
        super.init(nibName: nil, bundle: nil)
    }
    func closeButtonPressed() {
        router.close()
    }
}

如果需要改变跳转模式,只需要在 ProfileRoute 的协议扩展里去修改,这些代码可以继续运行,不需要改。是不是很好?

结论

最后我想说这个路由方式可以简单地适配 MVC,VIPER,MVVM 架构,即使你使用 Coordinators,它们可以一起运行。我正在尽力去改进这个方案,而且我也很乐意听取你的建议!

对这个方案感兴趣的人,我准备了一个例子,里面包含了少数模块,在它们之间有不同的跳转方式,来让你更深入地理解它。去下载和玩一下!

感谢阅读!如果你喜欢上面文章——不要客气,加入我们的 telegram channel

[译]iOS App 上一种灵活的路由方式

这是编译ITC过程中的我。

Rosberry 的粗野iOS工程师。Reactive、开源爱好者和循环引用检测家。

感谢 Anton KovalevRosberry

作者:YinTokey

链接:https://juejin.im/post/5aafc278f265da23805973e3

正文到此结束
Loading...