SwiftUI 전문가 기술
운영 규칙
- 모든 작업 시작 시
references/latest-apis.md를 참조하여 deprecated API를 피하세요 - 가능하면 UIKit/AppKit 브리징보다 네이티브 SwiftUI API를 선호하세요
- 정확성과 성능에 집중하세요. 특정 아키텍처(MVVM, VIPER 등)를 강제하지 마세요
- 비즈니스 로직과 뷰를 분리하여 테스트 가능성을 높이되, 방법을 강제하지 마세요
- Apple의 Human Interface Guidelines 및 API 설계 패턴을 따르세요
- 사용자가 명시적으로 요청할 때만 Liquid Glass를 도입하세요 (
references/liquid-glass.md참조) - 성능 최적화는 요구사항이 아닌 제안으로 제시하세요
- 버전별 API에는 적절한 폴백과 함께
#available게이팅을 사용하세요
작업 워크플로우
기존 SwiftUI 코드 검토
- 검토 중인 코드를 읽고 해당하는 주제를 식별하세요
- deprecated API를 플래그하세요 (
references/latest-apis.md와 비교) - 각 관련 주제에 대해 아래 Topic Router를 실행하세요
- iOS 26+ 기능에 대한
#available게이팅 및 폴백 경로를 검증하세요
기존 SwiftUI 코드 개선
- Topic Router 주제에 대해 현재 구현을 감사하세요
- deprecated API를
references/latest-apis.md의 최신 동등 API로 교체하세요 - 불필요한 상태 업데이트를 줄이기 위해 핫 경로를 리팩토링하세요
- 복잡한 뷰 바디를 별도의 하위 뷰로 추출하세요
UIImage(data:)가 발견되면 이미지 다운샘플링을 제안하세요 (선택적 최적화,references/image-optimization.md참조)
새로운 SwiftUI 기능 구현
- 먼저 데이터 흐름을 설계하세요: 소유 상태와 주입된 상태를 식별하세요
- 최적의 diffing을 위해 뷰를 구성하세요 (하위 뷰를 조기에 추출)
- 올바른 애니메이션 패턴(암시적 vs 명시적, 전환)을 적용하세요
- 모든 탭 가능한 요소에는
Button을 사용하고, 접근성 그룹화 및 레이블을 추가하세요 - 버전별 API를
#available로 게이트하고 폴백을 제공하세요
Topic Router
현재 작업과 관련된 각 주제에 대해 참조 파일을 참조하세요:
| 주제 | 참조 |
|---|---|
| 상태 관리 | references/state-management.md |
| 뷰 구성 | references/view-structure.md |
| 성능 | references/performance-patterns.md |
| Lists 및 ForEach | references/list-patterns.md |
| 레이아웃 | references/layout-best-practices.md |
| 시트 및 내비게이션 | references/sheet-navigation-patterns.md |
| ScrollView | references/scroll-patterns.md |
| 애니메이션 (기본) | references/animation-basics.md |
| 애니메이션 (전환) | references/animation-transitions.md |
| 애니메이션 (고급) | references/animation-advanced.md |
| 접근성 | references/accessibility-patterns.md |
| Swift Charts | references/charts.md |
| 차트 접근성 | references/charts-accessibility.md |
| 이미지 최적화 | references/image-optimization.md |
| Liquid Glass (iOS 26+) | references/liquid-glass.md |
| macOS scenes | references/macos-scenes.md |
| macOS 윈도우 스타일링 | references/macos-window-styling.md |
| macOS 뷰 | references/macos-views.md |
| Deprecated API 조회 | references/latest-apis.md |
정확성 체크리스트
다음은 엄격한 규칙입니다. 위반은 항상 버그입니다:
-
@State속성은private입니다 -
@Binding은 자식이 부모 상태를 수정하는 경우에만 사용합니다 - 전달된 값은
@State또는@StateObject로 선언되지 않습니다 (업데이트를 무시함) -
@StateObject는 뷰가 소유한 객체에,@ObservedObject는 주입된 객체에 사용합니다 - iOS 17+:
@State는@Observable과 함께 사용하며,@Bindable은 바인딩이 필요한 주입된 관찰 가능 객체에 사용합니다 -
ForEach는 안정적인 식별자를 사용합니다 (동적 콘텐츠에는 절대.indices를 사용하지 않음) -
ForEach요소당 뷰 수는 일정합니다 -
.animation(_:value:)는 항상value매개변수를 포함합니다 - iOS 26+ API는
#available로 게이트되고 폴백이 제공됩니다 - 차트 타입을 사용하는 파일에는
import Charts가 있습니다
참조
references/latest-apis.md-- 모든 작업에 대해 먼저 읽으세요. Deprecated API에서 최신 API로의 전환 (iOS 15+ ~ iOS 26+)references/state-management.md-- 프로퍼티 래퍼, 데이터 흐름,@Observable마이그레이션references/view-structure.md-- 뷰 추출, 컨테이너 패턴,@ViewBuilderreferences/performance-patterns.md-- 핫 경로 최적화, 업데이트 제어,_logChanges()references/list-patterns.md-- ForEach 식별자, Table (iOS 16+), 인라인 필터링 함정references/layout-best-practices.md-- 레이아웃 패턴, GeometryReader 대안references/accessibility-patterns.md-- VoiceOver, Dynamic Type, 그룹화, 트레이트references/animation-basics.md-- 암시적/명시적 애니메이션, 타이밍, 성능references/animation-transitions.md-- 뷰 전환,matchedGeometryEffect,Animatablereferences/animation-advanced.md-- 위상/키프레임 애니메이션 (iOS 17+),@Animatable매크로 (iOS 26+)references/charts.md-- Swift Charts 마크, 축, 선택, 스타일링, Chart3D (iOS 26+)references/charts-accessibility.md-- 차트 VoiceOver, 오디오 그래프, 폴백 전략references/sheet-navigation-patterns.md-- 시트, NavigationSplitView, Inspectorreferences/scroll-patterns.md-- ScrollViewReader, 프로그래매틱 스크롤링references/image-optimization.md-- AsyncImage, 다운샘플링, 캐싱references/liquid-glass.md-- iOS 26+ Liquid Glass 효과 및 폴백 패턴references/macos-scenes.md-- 설정, MenuBarExtra, WindowGroup, 멀티 윈도우references/macos-window-styling.md-- 툴바 스타일, 윈도우 크기 조정, Commandsreferences/macos-views.md-- HSplitView, Table, PasteButton, AppKit 상호 운용