[iOS] How to use the coordinator pattern in iOS apps 해석 및 정리

How to use the coordinator pattern in iOS apps

VC가 코디네이터를 소유하는 방식으로 조금 더 간단하다.

영어 해석과 코드 예제 위주로 정리.

iOS앱에서 코디네이터 패턴을 사용하는 방법

view controller와 navigation controller를 단순화하기.

여기서는 child coordinator 사용 직전까지 배운다.

child coordinator 사용법은 다음 문서에서 배운다.

iOS 앱에서 코디네이터 패턴을 사용하면…

• View Controller에서 앱 탐색(app navigation) 작업을 제거할 수 있다.
• 우리가 필요할 때 앱의 흐름을 조정할 수 있다.
• ViewController들을 관리하고 재사용하기 더 쉬워진다.
• massive view controller를 막는 방법 중 하나이다.

뷰 컨트롤러는 앱에서 독립적일 때 가장 잘 작동한다. 뷰 컨트롤러는 앱의 플로우 속에서 자신의 위치를 의식하지 않고, 그리고 처음부터 자신이 프름의 일부라는 것조차 모를 정도로 독립적인 것이 좋다.

이것은 코드의 테스트와 추론을 쉽게 해줄 뿐 아니라, 당신의 앱 내부에서 뷰컨트롤러의 재사용을 더욱 쉽게 해 줍니다.

무엇을 바꿔야 하는가?

iOS 개발자라면 백번도 넘게 작성했을 코드를 먼저 살펴보자.

if let vc = storyboard?.instantiateViewController(withIdentifier: "SomeVC") {
    navigationController?.pushViewController(vc, animated: true)
}

이런 코드에서, 하나의 뷰 컨트롤러는 반드시 다른 뷰 컨트롤러를 생성하고, 구성하고, 표시해야 한다.

이는 당신의 앱에서 강한 결합을 형성한다: 당신은 뷰 컨트롤러 간의 연결을 하드코딩하고, 심지어 같은 뷰 컨트롤러가 여러 장소에서 보여져야 할 때 이러한 구성 코드를 복사했을지도 모른다.

 

당신이 아이패드 사용자, VoiceOver 사용자, A/B테스트의 사용자 일부를 위한 다른 동작을 원한다면 어떻게 되겠는가? 당신이 할 수 있는 유일한 선택은 뷰 컨트롤러에 더 많은 구성 코드를 작성하는 것 뿐이며, 문제는 더 심각해질 뿐이다.

 

더 심각한 것은, 이 모든 것이 ‘자신의 내비게이션 컨트롤러에게 무엇을 하라고 지시하는 자식’을 포함한다는 것이다 - 우리의 첫 번째 뷰 컨트롤러는 자신의 부모에게까지 접근해, 부모에게 두 번째 뷰 컨트롤러를 표시하도록 지시한다.

 

이런 문제를 깔끔하게 해결하기 위해서, 코디네이터 패턴은 뷰 컨트롤러들의 연결을 끊어서 각각의 뷰 컨트롤러가 자신의 전후에 무엇이 있는지, 그리고 뷰 컨트롤러의 흐름이 있는지조차 모르게 만들어 준다.

 

그 대신, 당신의 앱 흐름(flow)은 코디네이터를 사용해 제어되며, 뷰는 코디네이터를 통해서만 소통하게 된다. 만약 당신이 사용자 인증을 받고 싶다면, 코디네이터에게 인증 다이얼로그를 표시하도록 요청해야 한다. 코디네이터가 그것이 무엇을 의미하는지 이해하고 적절하게 표시해 줄 것이다.

 

결과적으로 당신은 당신이 어떤 순서로든 뷰 컨트롤러들을 사용할 수 있음을 알게 될 것이다. 필요에 따라 그것들을 사용하거나 재사용할 수 있다. 더 이상 당신의 앱에 하드코딩된 경로는 없다. 당신의 앱의 서로 다른 다섯개의 부분에서 사용자 인증을 받더라도 상관없다. 왜냐하면 자신의 코디네이터에서 같은 메서드를 호출할 수 있기 때문이다.

 

더 큰 앱을 위해서는, 자식 코디네이터 child coordinators(또는 서브코디네이터 subcoordinators)를 생성할 수도 있을 것이다 - 이것은 당신의 앱 탑색의 일부를 분리할 수 있게 해 줍니다. 예를 들어, 어떤 자식 코디네이터는 계성 생성 흐름을 제어하는 데 사용하고, 다른 것은 제품 구독 흐름을 제어하는 데 사용할 수 있다.

 

만약 더 많은 유연함을 원한다면, 뷰 컨트롤러와 코디네이터 간의 대화가 구체 타입보다 프로토콜을 통해 이루어지도록 하는 것도 좋은 생각이다. 이것은 나중에 당신이 코디네이터 전체를 다른 포인트로 대체할 수 있도록 해 줄 것이며, 다른 프로그램 흐름을 갖도록 한다 - 예를 들어 당신은 아이폰, 아이패드, 애플TV 등에 대한 각각의 코디네이터를 제공할 수 있다.

 

따라서, 당신이 거대한 뷰 컨트롤러 때문에 고군분투하고 있다면, 내비게이션(탐색)을 단순화하는 것이 도움이 된다는 것을 알게 될 것이라고 생각한다. 이제 추상적인 이야기는 충분하다 - 실제 프로젝트에 코디네이터를 사용해 보자.

코디네이터 프로토콜 만들기

Coordinator 프로토콜

import UIKit

protocol Coordinator: AnyObject {
    var childCoordinators: [Coordinator] { get set }
    var navigationController: UINavigationController { get set }

    func start()
}

• childCoordinators : 자식 코디네이터를 저장
• navigationController : 뷰컨트롤러를 보여줄 때 사용될 내비게이션 컨트롤러를 저장.
  • 내비게이션 바를 표시하지 않더라도, 내비게이션 컨트롤러를 사용하는 것이 뷰 컨트롤러를 보여주는 가장 쉬운 방법이다.
• start() : 해당 코디네이터가 제어권을 갖도록 하는 메서드. 완전히 만들고 준비되었을 때만 코디네이터를 활성화함.
• AnyObject : 클래스에서만 사용 가능한 프로토콜임을 명시

코디네이터 만들고 실행하기

MainCoordinator

앱 실행과 동시에 앱에 대한 제어권을 갖는 첫 번째 코디네이터.

자식 코디네이터까지 있는 경우, AppCoordinator라고 이름짓기도 한다.

import UIKit

class MainCoordinator: Coordinator {
    var childCoordinators = [Coordinator]()
    var navigationController: UINavigationController

    init(navigationController: UINavigationController) {
        self.navigationController = navigationController
    }

    func start() {
        let vc = ViewController.instantiate()
                vc.coordinator = self
        navigationController.pushViewController(vc, animated: false)
    }
}

• 해당 코디네이터가 다른 뷰컨들에 의해 공유될 것이기 때문에 struct보다 class로 선언
• Coordinator 프로토콜을 준수
• start() : ViewController 클래스의 인스턴스를 생성하고, navigationController에 push한다.

✅ MainCoordinator는 ViewController가 아니다.

(UIKit에 의해 자동으로 호출되는 viewDidLoad(), viewWillAppear()와 같은 메서드를 사용하지 않으며, UIViewController의 단점과 싸울 필요가 없다.)

AppDelegate

앱이 시작할 때 위 코디네이터를 사용할 수 있도록 AppDelegate에 코드를 추가한다.

// AppDelegate.swift

var coordinator: MainCoordinator? // <- 해당 프로퍼티를 앱델리게이트에 추가

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    // 앱에서 사용할 메인 네비게이션 컨트롤러를 생성
    let navController = UINavigationController()

    // 메인 코디네이터에 네비게이션 컨트롤러를 넣음 - 뷰 컨트롤러를 보여주기 위해
    coordinator = MainCoordinator(navigationController: navController)

    // 코디네이터가 제어권을 갖도록 지시
    coordinator?.start()

    // 기본 UIWindow를 만들고 활성화하기
    window = UIWindow(frame: UIScreen.main.bounds)
    window?.rootViewController = navController
    window?.makeKeyAndVisible()

    return true
}

• var coordinator: MainCoordinator?
  • 앱의 메인 코디네이터를 저장해 메모리에서 해제되는 것을 방지한다.
• func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool
  • MainCoordinator를 구성 및 실행
  • 앱의 기본 window를 설정
  • (원래 기본 window는 스토리보드에 의해 설정되지만, 이제는 우리의 책임이다)

앱의 흐름 처리하기

ViewController

• 모든 뷰컨트롤러들은 자신의 코디네이터와 대화할 수 있어야 한다.
  • 프로토콜을 사용하거나, (큰 앱의 경우) - Advanced coordinators in iOS 참고
  • 코디네이터를 프로퍼티로 직접 소유할 수 있다 (작은 앱의 경우)
    • weak var coordinator: MainCoordinator?

Coordinator로 화면 전환

코디네이터에 화면을 전환할 메서드를 추가해 뷰 컨트롤러 사이를 이동할 수 있다.

• start()와 거의 비슷하게 생겼지만, 보여주는 뷰컨트롤러가 조금씩 다르다
• 뷰컨트롤러에 대한 어떤 구성 작업이 필요하다면 해당 메서드에서 진행하면 된다.

// MainCoordinator에 추가
func buySubscription() {
    let vc = BuyViewController.instantiate()
    vc.coordinator = self
    navigationController.pushViewController(vc, animated: true)
}

func createAccount() {
    let vc = CreateAccountViewController.instantiate()
    vc.coordinator = self
    navigationController.pushViewController(vc, animated: true)
}

• 그 다음, 뷰컨트롤러에서 화면을 전환해야 하는 이벤트가 발생했을 때 coordinator의 해당 메서드를 호출하면 화면이 전환된다.

// 화면전환이 필요한 이벤트가 발생하는 ViewController에 추가
@IBAction func buyTapped(_ sender: Any) {
    coordinator?.buySubscription()
}

@IBAction func createAccount(_ sender: Any) {
    coordinator?.createAccount()
}