SwiftUI 뷰 리팩토링
개요
SwiftUI 뷰에 일관된 구조와 의존성 패턴을 적용하며, 순서, Model-View 패턴, 신중한 뷰 모델 처리, 올바른 Observation 사용법에 초점을 맞춥니다.
핵심 가이드라인
1) 뷰 속성 순서 (위 → 아래)
- Environment
private/publiclet@State/ 기타 저장 속성- 계산된
var(뷰 제외) initbody- 계산된 뷰 빌더 / 기타 뷰 헬퍼
- 헬퍼 / 비동기 함수
2) MV 패턴 선호
- 기본값은 MV: 뷰는 가벼운 상태 표현이며, 모델/서비스가 비즈니스 로직을 소유합니다.
- 오케스트레이션에는
@State,@Environment,@Query,task/onChange를 선호합니다. - 서비스와 공유 모델은
@Environment를 통해 주입하고, 뷰는 작고 합성 가능하게 유지합니다. - 뷰 모델을 도입하기보다는 큰 뷰를 하위 뷰로 분할합니다.
3) 큰 body 및 뷰 속성 분할
body가 한 화면을 넘거나 여러 논리적 섹션이 있으면 더 작은 하위 뷰로 분할합니다.- 큰 계산된 뷰 속성(
var header: some View { ... })은 상태나 복잡한 분기가 있을 때 전용View타입으로 추출합니다. - 관련 하위 뷰를 같은 파일에 계산된 뷰 속성으로 유지해도 괜찮지만, 구조적으로 의미가 있거나 재사용이 의도될 때만 별도의
View구조체로 추출합니다. - 상위 뷰 상태 전체를 재사용하기보다는 작은 입력(데이터, 바인딩, 콜백)을 전달하는 것을 선호합니다.
예시 (섹션 추출):
var body: some View {
VStack(alignment: .leading, spacing: 16) {
HeaderSection(title: title, isPinned: isPinned)
DetailsSection(details: details)
ActionsSection(onSave: onSave, onCancel: onCancel)
}
}
예시 (긴 body → 짧은 body + 동일 파일 내 계산된 뷰):
var body: some View {
List {
header
filters
results
footer
}
}
private var header: some View {
VStack(alignment: .leading, spacing: 6) {
Text(title).font(.title2)
Text(subtitle).font(.subheadline)
}
}
private var filters: some View {
ScrollView(.horizontal, showsIndicators: false) {
HStack {
ForEach(filterOptions, id: \.self) { option in
FilterChip(option: option, isSelected: option == selectedFilter)
.onTapGesture { selectedFilter = option }
}
}
}
}
예시 (복잡한 계산된 뷰 추출):
private var header: some View {
HeaderSection(title: title, subtitle: subtitle, status: status)
}
private struct HeaderSection: View {
let title: String
let subtitle: String?
let status: Status
var body: some View {
VStack(alignment: .leading, spacing: 4) {
Text(title).font(.headline)
if let subtitle { Text(subtitle).font(.subheadline) }
StatusBadge(status: status)
}
}
}
4) 뷰 모델 처리 (이미 존재하는 경우에만)
- 요청이나 기존 코드에 명확히 필요하지 않으면 뷰 모델을 도입하지 마십시오.
- 뷰 모델이 이미 존재하면 가능한 옵셔널 대신 non-optional로 만듭니다.
- 의존성을
init을 통해 뷰에 전달한 후, 뷰의init에서 뷰 모델에 전달합니다. bootstrapIfNeeded패턴은 피합니다.
예시 (Observation 기반):
@State private var viewModel: SomeViewModel
init(dependency: Dependency) {
_viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}
5) Observation 사용법
@Observable참조 타입은 루트 뷰에서@State로 저장합니다.- 필요에 따라 observable을 명시적으로 전달하고, 필수가 아닌 이상 옵셔널 상태는 피합니다.
작업 흐름
- 순서 규칙에 맞게 뷰의 속성 순서를 재정렬합니다.
- MV를 선호:
@State,@Environment,@Query,task,onChange를 사용하여 가벼운 오케스트레이션을 뷰로 이동합니다. - 뷰 모델이 있으면, 옵셔널 뷰 모델을 non-optional
@State뷰 모델로 교체하고, 뷰에서 의존성을 전달하여init에서 초기화합니다. - Observation 사용법 확인: 루트
@Observable뷰 모델에는@State를 사용하고, 중복 래퍼는 제거합니다. - 동작은 그대로 유지: 요청되지 않은 레이아웃이나 비즈니스 로직은 변경하지 않습니다.
참고 사항
- 큰 조건부 블록보다는 작고 명시적인 헬퍼를 선호합니다.
- 계산된 뷰 빌더는
body아래에, 뷰가 아닌 계산된 변수는init위에 유지합니다. - MV 우선 가이드 및 근거에 대해서는
references/mv-patterns.md를 참조하세요.
큰 뷰 처리
- SwiftUI 뷰 파일이 약 300줄을 초과하면 확장(extension)을 사용하여 관련 헬퍼를 그룹화합니다. 비동기 함수와 헬퍼 함수는 전용
private확장으로 이동하고, 목적을 설명하는// MARK: -주석(예:// MARK: - Actions,// MARK: - Subviews,// MARK: - Helpers)으로 구분합니다. 기본struct는 저장 속성, init, body에 집중하고, 뷰를 구성하는 계산된 변수도 파일이 길 때 마크를 통해 그룹화합니다.