Coordinator와 화면 전환 설계
UIKit 앱에서 View Controller가 다음 화면 생성, 데이터 전달, push와 present까지 모두 맡기 시작하면 화면 전환 코드가 빠르게 복잡해진다. Coordinator 패턴은 이 이동 흐름을 별도 객체로 분리한다.
Coordinator는 Apple 프레임워크가 제공하는 정식 타입이 아니라 애플리케이션 설계 패턴이다. 따라서 프로젝트마다 구현이 다를 수 있으며, 모든 앱에 무거운 계층 구조가 필요한 것은 아니다.
화면 전환 코드의 출발점
push는 내비게이션 스택에 화면을 추가하고, present는 다른 화면을 모달로 표시한다. Coordinator는 이 UIKit 기능을 대신 구현하지 않고, 언제 어떤 화면을 만들지 결정한다.
첫 예제는 HomeViewController와 DetailViewController가 앱에 정의돼 있다고 가정한다. 이어지는 자식 Coordinator 코드는 기존 클래스에 추가할 구조를 설명한다. 동일한 이름의 클래스를 한 파일에 두 번 선언하는 완성 예제는 아니다.
가장 작은 Coordinator
protocol Coordinator: AnyObject {
var navigationController: UINavigationController { get }
func start()
}
final class AppCoordinator: Coordinator {
let navigationController: UINavigationController
init(navigationController: UINavigationController) {
self.navigationController = navigationController
}
func start() {
let viewController = HomeViewController()
viewController.onShowDetail = { [weak self] itemID in
self?.showDetail(itemID: itemID)
}
navigationController.setViewControllers(
[viewController],
animated: false
)
}
private func showDetail(itemID: String) {
let viewController = DetailViewController(itemID: itemID)
navigationController.pushViewController(
viewController,
animated: true
)
}
}
View Controller는 “상세 화면을 보여 달라”는 사용자 의도만 클로저로 전달한다. 구체적으로 어떤 화면을 만들고 어떻게 이동할지는 Coordinator가 결정한다.
장점
- 화면이 다른 View Controller의 생성 방법을 알 필요가 없다.
- 로그인 여부나 딥 링크에 따라 흐름을 바꾸기 쉽다.
- 화면 전환 규칙을 한곳에서 읽고 테스트할 수 있다.
- 같은 화면을 여러 흐름에서 재사용하기 쉬워진다.
자식 Coordinator의 수명 관리
로그인이나 결제처럼 여러 화면으로 이어지는 흐름은 별도 Coordinator로 분리할 수 있다. 부모는 자식을 강하게 보관하고, 자식 흐름이 끝났다는 알림을 받으면 배열에서 제거한다.
final class AppCoordinator: Coordinator {
var childCoordinators: [Coordinator] = []
func showLogin() {
let child = LoginCoordinator(
navigationController: navigationController
)
child.onFinish = { [weak self, weak child] in
guard let self, let child else { return }
self.childCoordinators.removeAll { $0 === child }
self.showHome()
}
childCoordinators.append(child)
child.start()
}
}
자식을 배열에 넣지 않으면 start() 직후 해제될 수 있고, 끝난 자식을 제거하지 않으면 화면이 닫혀도 메모리에 남는다. 화면을 뒤로 스와이프해 종료하는 경우까지 포함해 완료 시점을 설계해야 한다.
데이터 전달 방식
Coordinator가 모든 화면 데이터까지 직접 가공하면 또 다른 거대한 객체가 된다. Coordinator는 화면 생성과 흐름 선택을 담당하고, 화면에 표시할 데이터와 비즈니스 로직은 ViewModel이나 Use Case에 맡긴다.
이전 화면으로 결과를 돌려줄 때는 delegate, 완료 클로저, async 함수 중 프로젝트의 흐름에 맞는 방식을 사용한다. 어떤 방식을 택하든 구체적인 View Controller 타입을 서로 직접 참조하지 않게 만드는 것이 핵심이다.
주의할 점
자식 Coordinator를 배열에 보관하는 구조에서는 흐름이 끝날 때 반드시 제거해야 한다. 그렇지 않으면 부모와 자식, 클로저 사이에 순환 참조가 생길 수 있다. View Controller가 Coordinator를 강하게 소유하게 만들기보다 약한 delegate나 [weak self] 클로저를 사용하는 편이 안전하다.
또한 화면이 두세 개뿐인 앱에 Coordinator 계층을 과하게 만들면 추적할 파일만 늘어난다. 다음 조건에서 도입 효과가 크다.
- 인증, 온보딩, 결제처럼 독립된 화면 흐름이 있다.
- 딥 링크나 푸시 알림이 여러 진입점을 만든다.
- 하나의 View Controller가 여러 다음 화면을 직접 생성한다.
UINavigationController는 화면 스택을 관리하고, Coordinator는 앱의 이동 규칙을 관리한다. 두 역할을 구분하면 구현을 단순하게 유지할 수 있다.