ReactiveCoordinator 4.0.0

ReactiveCoordinator 4.0.0

Zafar Ivaev 维护。



  • Zafar Ivaev

ReactiveCoordinator

ReactiveCoordinator 是一个基于 Coordinator 模式的框架,由 RxSwift 实现。

要求

  • iOS 11.0
  • Swift 5

安装

CocoaPods

CocoaPods 是 Cocoa 项目的依赖管理器。对于用法和安装说明,请访问其网站。要在 CocoaPods 中使用 CocoaPods 同步到您的 Xcode 项目中,请在您的 Podfile 中将其指定。

pod 'ReactiveCoordinator', '4.0.0'

如何使用

在 Coordinator 子类中继承 ReactiveCoordinator

class HolidaysCoordinator: ReactiveCoordinator<Void> {
    
    let rootViewController: UIViewController
    
    init(rootViewController: UIViewController) {
        self.rootViewController = rootViewController
    }
    
    override func start() -> Observable<Void> {
        
        let viewController = HolidaysViewController()
        let viewModel = HolidaysViewModel()
        viewController.viewModel = viewModel
        
        rootViewController.navigationController?.pushViewController(viewController, animated: true)
        
        return Observable.empty()
    }
    
}

用ReactiveCoordinator替换委托

在提到的协调器中

enum ChooseCountryCoordinationResult {
    case country(String)
    case cancel
}

class ChooseCountryCoordinator: ReactiveCoordinator<ChooseCountryCoordinationResult> {
    
    private let rootViewController: UIViewController
    
    init(rootViewController: UIViewController) {
        self.rootViewController = rootViewController
    }
    
    override func start() -> Observable<CoordinationResult> {
        let viewController = ChooseCountryViewController()
        let navigationController = UINavigationController(rootViewController: viewController)
        
        let viewModel = ChooseCountryViewModel()
        viewController.viewModel = viewModel
        
        let country = viewModel.selectedCountry.map { CoordinationResult.country($0) }
        let cancel = viewModel.didClose.map { _ in
            CoordinationResult.cancel
        }
        
        rootViewController.present(navigationController, animated: true, completion: nil)
        
        return Observable.merge(country, cancel)
            .take(1)
            .do(onNext: { _ in
                viewController.dismiss(animated: true, completion: nil)
            })
    }
    
}

在提出的协调器中

class HolidaysCoordinator: ReactiveCoordinator<Void> {
    
    let rootViewController: UIViewController
    
    init(rootViewController: UIViewController) {
        self.rootViewController = rootViewController
    }
    
    override func start() -> Observable<Void> {
        
        let viewController = HolidaysViewController()
        let viewModel = HolidaysViewModel()
        viewController.viewModel = viewModel
        
        viewModel.chooseCountry
            .flatMap { [weak self] _ -> Observable<String?> in
                guard let `self` = self else { return .empty() }
                return self.coordinateToChooseCountry()
        }
        .filter { $0 != nil }
        .map { $0! }
        .bind(to: viewModel.selectedCountry)
        .disposed(by: disposeBag)
        
        return Observable.never()
    }
    
    // MARK: - Coordination
    private func coordinateToChooseCountry() -> Observable<String?> {
        let chooseCountryCoordinator = ChooseCountryCoordinator(rootViewController: rootViewController)
        return coordinate(to: chooseCountryCoordinator)
            .map { result in
                switch result {
                case .country(let country): return country
                case .cancel: return nil
                }
        }
    }
    
}

许可

ReactiveCoordinator遵循MIT许可。详情请见LICENSE