SwiftUI 성능 감사
귀속: @Dimillian의 Dimillian/Skills (2025-12-31)에서 가져옴.
개요
SwiftUI 뷰 성능을 계측(instrumentation)과 기준 측정(baselining)부터 근본 원인 분석 및 구체적인 수정 단계까지 종단간(end-to-end) 감사합니다.
워크플로우 결정 트리
- 사용자가 코드를 제공하면 "코드 우선 검토"로 시작합니다.
- 사용자가 증상만 설명하는 경우, 최소한의 코드/컨텍스트를 요청한 후 "코드 우선 검토"를 수행합니다.
- 코드 검토가 불분명하면 "사용자에게 프로파일링 안내"로 이동하여 트레이스(trace) 또는 스크린샷을 요청합니다.
1. 코드 우선 검토
수집:
- 대상 뷰/기능 코드.
- 데이터 흐름: 상태, 환경, 관찰 가능 모델.
- 증상 및 재현 단계.
집중할 사항:
- 광범위한 상태 변경으로 인한 뷰 무효화 폭풍.
- 리스트의 불안정한 식별자(
id변경, 렌더링 시UUID()호출). body내의 과도한 작업(포맷팅, 정렬, 이미지 디코딩).- 레이아웃 스래싱(깊은 스택,
GeometryReader, 선호도 체인). - 다운샘플링 또는 크기 조정 없이 사용되는 큰 이미지.
- 과도한 애니메이션 계층 구조(대규모 트리에 대한 암시적 애니메이션).
제공:
- 코드 참조와 함께 가능한 근본 원인.
- 제안된 수정 및 리팩토링.
- 필요한 경우 최소한의 재현 코드 또는 계측 제안.
2. 사용자에게 프로파일링 안내
Instruments로 데이터를 수집하는 방법 설명:
- Instruments에서 SwiftUI 템플릿 사용(Release 빌드).
- 정확한 상호작용(스크롤, 탐색, 애니메이션) 재현.
- SwiftUI 타임라인과 Time Profiler 캡처.
- 관련 레인(lanes)과 호출 트리(call tree) 내보내기 또는 스크린샷.
요청:
- SwiftUI 레인 + Time Profiler 호출 트리의 트레이스 내보내기 또는 스크린샷.
- 기기/OS/빌드 구성.
3. 분석 및 진단
가능성이 높은 SwiftUI 원인 우선순위 지정:
- 광범위한 상태 변경으로 인한 뷰 무효화 폭풍.
- 리스트의 불안정한 식별자(
id변경, 렌더링 시UUID()호출). body내의 과도한 작업(포맷팅, 정렬, 이미지 디코딩).- 레이아웃 스래싱(깊은 스택,
GeometryReader, 선호도 체인). - 다운샘플링 또는 크기 조정 없이 사용되는 큰 이미지.
- 과도한 애니메이션 계층 구조(대규모 트리에 대한 암시적 애니메이션).
트레이스/로그의 증거와 함께 결과 요약.
4. 수정
대상별 수정 적용:
- 상태 범위 좁히기(
@State/@Observable을 리프 뷰에 더 가깝게). ForEach및 리스트의 식별자 안정화.body밖으로 무거운 작업 이동(사전 계산, 캐싱,@State).- 비용이 많이 드는 서브트리에
equatable()또는 값 래퍼 사용. - 렌더링 전에 이미지 다운샘플링.
- 레이아웃 복잡성 줄이기 또는 가능하면 고정 크기 사용.
일반적인 코드 냄새 (및 수정)
코드 검토 중에 다음 패턴을 찾으세요.
body 내의 비싼 포매터
var body: some View {
let number = NumberFormatter() // 느린 할당
let measure = MeasurementFormatter() // 느린 할당
Text(measure.string(from: .init(value: meters, unit: .meters)))
}
모델 또는 전용 헬퍼에 캐시된 포매터를 선호:
final class DistanceFormatter {
static let shared = DistanceFormatter()
let number = NumberFormatter()
let measure = MeasurementFormatter()
}
무거운 작업을 수행하는 계산 속성
var filtered: [Item] {
items.filter { $0.isEnabled } // 모든 body 평가 시 실행
}
변경 시 사전 계산 또는 캐싱 선호:
@State private var filtered: [Item] = []
// 입력 변경 시 filtered 업데이트
body 또는 ForEach 내의 정렬/필터링
List {
ForEach(items.sorted(by: sortRule)) { item in
Row(item)
}
}
뷰 업데이트 전에 한 번 정렬 선호:
let sortedItems = items.sorted(by: sortRule)
ForEach 내의 인라인 필터링
ForEach(items.filter { $0.isEnabled }) { item in
Row(item)
}
안정적인 식별자를 가진 사전 필터링된 컬렉션 선호.
불안정한 식별자
ForEach(items, id: \.self) { item in
Row(item)
}
비안정적인 값에 대해 id: \.self를 피하고, 안정적인 ID를 사용하세요.
메인 스레드에서의 이미지 디코딩
Image(uiImage: UIImage(data: data)!)
메인 스레드 외부에서 디코딩/다운샘플링하고 결과를 저장하는 것을 선호.
관찰 가능 모델의 광범위한 의존성
@Observable class Model {
var items: [Item] = []
}
var body: some View {
Row(isFavorite: model.items.contains(item))
}
업데이트 전파(fan-out)를 줄이기 위해 세분화된 뷰 모델 또는 항목별 상태를 선호.
5. 검증
사용자에게 동일한 캡처를 다시 실행하고 기준 메트릭과 비교하도록 요청하세요.
제공된 경우 델타(CPU, 프레임 드롭, 메모리 피크)를 요약합니다.
출력물
제공:
- 간단한 메트릭 테이블(가능한 경우 이전/이후).
- 주요 문제(영향 순으로 정렬).
- 제안된 수정 사항 및 예상 노력.
참고 자료
사용자가 제공하는 대로 Apple 문서 및 WWDC 자료를 references/ 아래에 추가하세요.
- Instruments로 SwiftUI 성능 최적화:
references/optimizing-swiftui-performance-instruments.md - SwiftUI 성능 이해 및 개선:
references/understanding-improving-swiftui-performance.md - 앱의 멈춤 현상 이해:
references/understanding-hangs-in-your-app.md - SwiftUI 성능 이해하기 (WWDC23):
references/demystify-swiftui-performance-wwdc23.md