Communitygithub.com

SwiftUI 성능 최적화

UI가 느리거나, 스크롤이 끊기거나, 애니메이션이 버벅이거나, 'SwiftUI 뷰가 왜 느리지', 'List 성능을 최적화하는 방법', '앱이 프레임을 드롭해요', '뷰 바디가 너무 자주 호출돼요', 'List가 버벅여요'와 같은 질문이 있을 때 사용하세요. Instruments 26과 WWDC 2025 패턴을 활용한 SwiftUI 성능 최적화입니다.

SwiftUI 성능 최적화란 무엇인가요?

이 스킬은 Apple의 Instruments 26에 포함된 새로운 SwiftUI 계측기와 WWDC 2025에서 소개된 최신 성능 패턴을 활용하여 SwiftUI 애플리케이션의 성능을 진단하고 최적화하는 방법을 제공합니다. 사용자는 UI 반응 저하, 애니메이션 끊김, 스크롤 버벅임과 같은 문제를 해결하기 위해 이 스킬을 사용할 수 있습니다. 주요 기능으로는 긴 뷰 바디 업데이트 식별, 불필요한 뷰 업데이트 감지, SwiftUI 렌더 루프 이해, 그리고 Instruments를 통한 원인-결과 분석 그래프 활용법을 다룹니다. iOS 26의 자동 성능 개선 사항(예: 6배 빠른 리스트 로딩, 16배 빠른 리스트 업데이트, 드롭된 프레임 감소, 중첩 ScrollView 지연 로딩)을 설명합니다. 이 스킬은 특히 대규모 데이터 구조, 복잡한 뷰 계층 구조, UIKit/AppKit 브리징 성능 문제를 해결하는 데 유용하며, 궁극적으로 부드러운 120Hz ProMotion 경험을 제공하는 데 중점을 둡니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-swiftui-performance

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SwiftUI 성능 최적화은(는) 무엇을 하나요?

이 스킬을 사용해야 할 때

다음과 같은 경우에 사용하세요:

  • 앱이 덜 반응적일 때 (끊김, 멈춤, 스크롤 지연)
  • 애니메이션이 실행 중에 멈추거나 점프할 때
  • 스크롤 성능이 좋지 않을 때
  • 프로파일링 결과 SwiftUI가 병목으로 확인될 때
  • 뷰 바디가 실행되는 데 너무 오래 걸릴 때
  • 뷰가 필요 이상으로 자주 업데이트될 때
  • SwiftUI 업데이트의 원인과 결과를 이해해야 할 때

예시 프롬프트

다음은 개발자들이 실제로 묻는 질문으로, 이 스킬이 답변하도록 설계되었습니다:

1. "내 앱의 스크롤이 버벅이고 애니메이션이 끊깁니다. SwiftUI가 원인인지 어떻게 알 수 있나요?"

→ 이 스킬은 Instruments 26의 새로운 SwiftUI 계측기를 사용하여 SwiftUI가 다른 레이어와 비교해 병목인지 확인하는 방법을 보여줍니다.

2. "새로운 SwiftUI 계측기를 사용 중인데, 긴 업데이트를 나타내는 주황색/빨간색 막대가 보입니다. 무엇이 원인인지 어떻게 알 수 있나요?"

→ 이 스킬은 앱을 통한 데이터 흐름과 어떤 상태 변경이 비용이 많이 드는 업데이트를 유발하는지 보여주는 원인 및 결과 그래프 패턴을 다룹니다.

3. "일부 뷰가 데이터가 변경되지 않았음에도 너무 자주 업데이트됩니다. 문제가 되는 뷰를 어떻게 찾을 수 있나요?"

→ 이 스킬은 시각적 타임라인을 통한 불필요한 업데이트 감지 및 Identity 문제 해결 방법을 설명합니다.

4. "대규모 데이터 구조와 복잡한 뷰 계층 구조가 있습니다. SwiftUI 성능을 위해 어떻게 최적화할 수 있나요?"

→ 이 스킬은 뷰 계층 구조 분해, 바디 복잡성 최소화, @Sendable 최적화 체크리스트 사용 등 성능 패턴을 다룹니다.

5. "성능 관련 마감일이 있고 SwiftUI에서 무엇이 느린지 이해해야 합니다. 중요한 메트릭은 무엇인가요?"

→ 이 스킬은 최적화 우선순위를 정하기 위한 의사 결정 트리와 트레이드오프에 대한 전문가 지침을 제공합니다.


개요

핵심 원칙: 뷰 바디가 빠르게 업데이트되고 필요할 때만 업데이트되도록 하여 뛰어난 SwiftUI 성능을 달성하세요.

WWDC 2025의 새로운 기능: Instruments 26의 차세대 SwiftUI 계측기가 포괄적인 성능 분석을 제공합니다:

  • 긴 업데이트의 시각적 타임라인 (심각도에 따라 주황색/빨간색으로 색상 코딩)
  • 앱을 통한 데이터 흐름을 보여주는 원인 및 결과 그래프
  • CPU 분석을 위한 Time Profiler와의 통합
  • Hangs 및 Hitches 추적

주요 성능 문제:

  1. 긴 뷰 바디 업데이트 — 뷰 바디가 실행되는 데 너무 오래 걸림
  2. 불필요한 뷰 업데이트 — 데이터가 실제로 변경되지 않았는데 뷰가 업데이트됨

iOS 26 프레임워크 성능 개선

"프레임워크의 성능 개선은 Apple의 모든 플랫폼에서 앱에 이점을 제공합니다. 우리 앱에서 여러분의 앱까지." — WWDC 2025-256

iOS 26의 SwiftUI는 모든 앱에 자동으로 혜택을 주는 주요 성능 향상을 포함합니다. 이러한 개선 사항은 새로운 프로파일링 도구와 함께 작동하여 SwiftUI를 기본적으로 더 빠르게 만듭니다.

List 성능 (macOS 중심)

대규모 리스트를 위한 엄청난 향상

  • 6배 빠른 로딩 — macOS에서 100,000개 이상 항목의 리스트
  • 16배 빠른 업데이트 — 대규모 리스트
  • 더 큰 리스트일수록 더 큰 향상
  • 모든 플랫폼에 혜택 (iOS, iPadOS, watchOS, macOS만 해당 아님)
List(trips) { trip in // 100k+ items
    TripRow(trip: trip)
}
// iOS 26: 로딩 6배, 업데이트 16배 빠름 (macOS)
// 모든 플랫폼이 성능 개선의 혜택을 받음

앱에 미치는 영향

  • 대규모 데이터셋(10,000개 이상 항목)에서 눈에 띄는 개선
  • 필터링 및 정렬 작업이 더 빠르게 완료됨
  • 실시간 리스트 업데이트가 더 반응적으로 변함
  • 파일 브라우저, 연락처 목록, 데이터 테이블과 같은 앱에 혜택

스크롤 성능

고속 스크롤 중 드롭된 프레임 감소

SwiftUI는 iOS 및 macOS에서 UI 업데이트 스케줄링을 개선했습니다. 이는 반응성을 향상시키고 SwiftUI가 다가오는 프레임을 준비하기 위해 더 많은 작업을 수행할 수 있게 합니다. 요약하면, 고주사율로 빠르게 스크롤할 때 앱이 프레임을 드롭할 가능성을 줄여줍니다.

주요 개선 사항

  1. 더 나은 프레임 스케줄링 — SwiftUI가 다가오는 프레임을 준비할 시간을 더 확보
  2. 향상된 반응성 — UI 업데이트가 더 효율적으로 스케줄링됨
  3. 드롭된 프레임 감소 — 특히 120Hz(ProMotion)에서 빠르게 스크롤할 때

언제 체감할 수 있는가

  • 이미지가 많은 콘텐츠를 스크롤할 때
  • 고주사율 기기 (iPhone Pro, iPad Pro with ProMotion)
  • 여러 뷰가 포함된 복잡한 리스트 행

Lazy Stack을 사용한 중첩 ScrollViews

사진 캐러셀 및 다축 스크롤이 이제 제대로 최적화됨

ScrollView(.horizontal) {
    LazyHStack {
        ForEach(photoSets) { photoSet in
            ScrollView(.vertical) {
                LazyVStack {
                    ForEach(photoSet.photos) { photo in
                        PhotoView(photo: photo)
                    }
                }
            }
        }
    }
}
// iOS 26: 중첩 ScrollView가 이제 lazy stack과 함께 로딩을 적절히 지연시킴
// 사진 캐러셀, Netflix 스타일 레이아웃, 다축 콘텐츠에 적합

iOS 26 이전 중첩된 ScrollView가 lazy stack 콘텐츠의 로딩을 적절히 지연시키지 않아, 모든 중첩 콘텐츠가 즉시 로드되었습니다.

iOS 26 이후 중첩된 ScrollView 내부의 Lazy stack이 이제 콘텐츠가 나타나기 직전까지 로딩을 지연시켜, 단일 레벨 ScrollView의 동작과 일치합니다.

사용 사례

  • 수평/수직 스크롤이 있는 사진 갤러리
  • Netflix 스타일 카테고리 행
  • 다차원 데이터 브라우저
  • 세부 정보를 수직으로 스크롤하는 이미지 캐러셀

SwiftUI 성능 계측기 개선 사항

Instruments 26의 새로운 레인

SwiftUI 계측기에는 이제 전용 레인이 포함됩니다:

  1. 긴 뷰 바디 업데이트 — 비용이 많이 드는 body 계산 식별
  2. 플랫폼 뷰 업데이트 — UIKit/AppKit 브리징 성능 추적 (Long Representable Updates)
  3. 기타 긴 업데이트 — 다른 모든 유형의 긴 SwiftUI 작업

이러한 레인에 대한 자세한 내용은 다음 섹션에서 다룹니다.

성능 개선 요약

자동 혜택 (재컴파일만 필요)

  • ✅ 6배 빠른 리스트 로딩 (100k+ 항목, macOS)
  • ✅ 16배 빠른 리스트 업데이트 (macOS)
  • ✅ 스크롤 중 드롭된 프레임 감소
  • ✅ iOS/macOS에서 향상된 프레임 스케줄링
  • ✅ 중첩 ScrollView 지연 로딩 최적화

코드 변경 불필요 — iOS 26 SDK로 다시 빌드하면 이러한 개선 사항을 얻을 수 있습니다.

참조 SwiftUI 26 기능 (swiftui-26-ref 스킬) — 모든 iOS 26 SwiftUI 변경 사항에 대한 종합 가이드


SwiftUI 계측기 (Instruments 26)

시작하기

요구 사항:

  • Xcode 26 설치
  • 기기를 최신 OS 릴리스로 업데이트 (SwiftUI 트레이스 기록 지원)
  • 정확한 프로파일링을 위해 릴리스 모드로 앱 빌드

실행:

  1. Xcode에서 프로젝트 열기
  2. Command-I를 눌러 프로파일링
  3. 템플릿 선택기에서 SwiftUI 템플릿 선택
  4. Record 버튼 클릭

템플릿 내용

SwiftUI 템플릿에는 세 가지 계측기가 포함됩니다:

  1. SwiftUI 계측기 (신규) — SwiftUI 코드의 성능 문제 식별
  2. Time Profiler — 시간 경과에 따른 CPU 작업 샘플 표시
  3. Hangs and Hitches — 앱 반응성 추적

SwiftUI 계측기 트랙 레인

레인 1: 업데이트 그룹

  • SwiftUI가 활발히 작업 중인 시점 표시
  • CPU 스파이크 동안 비어 있음? → 문제가 SwiftUI 외부에 있을 가능성 높음

레인 2: 긴 뷰 바디 업데이트

  • body 프로퍼티가 너무 오래 걸리는 경우 강조 표시
  • 가장 흔한 성능 문제 — 여기서 시작

레인 3: 긴 Representable 업데이트

  • 느린 UIViewRepresentable/NSViewRepresentable 업데이트 식별
  • UIKit/AppKit 통합 성능

레인 4: 기타 긴 업데이트

  • 다른 모든 유형의 긴 SwiftUI 작업

색상 코딩 시스템

업데이트는 히치를 유발할 가능성에 따라 주황색과 빨간색으로 표시됩니다:

  • 빨간색 — 히치/행에 기여할 가능성이 매우 높음 (먼저 조사)
  • 주황색 — 문제를 유발할 가능성이 중간 정도
  • 회색 — 정상 업데이트, 우려 사항 아님

참고: 업데이트가 실제로 히치를 초래하는지 여부는 기기 상태에 따라 다르지만, 빨간색 업데이트가 최우선 순위입니다.


렌더 루프 이해하기

정상 프레임 렌더링

프레임 1:
├─ 이벤트 처리 (터치, 키 입력)
├─ UI 업데이트 (뷰 바디 실행)
│  └─ 프레임 마감 시간 전에 완료 ✅
├─ 시스템에 전달
└─ 시스템 렌더링 → 화면에 표시

프레임 2:
├─ 이벤트 처리
├─ UI 업데이트
│  └─ 프레임 마감 시간 전에 완료 ✅
├─ 시스템에 전달
└─ 시스템 렌더링 → 화면에 표시

결과: 부드럽고 유연한 애니메이션

히치가 있는 프레임 (긴 뷰 바디)

프레임 1:
├─ 이벤트 처리
├─ UI 업데이트
│  └─ 한 뷰 바디가 너무 느림
│  └─ 프레임 마감 시간 초과 ❌
├─ 마감 시간 놓침
└─ 이전 프레임이 계속 표시됨 (히치)

프레임 2: (지연됨)
├─ 이벤트 처리 (1프레임 지연)
├─ UI 업데이트
├─ 시스템에 전달
└─ 시스템 렌더링 → 마침내 표시됨

결과: 이전 프레임이 2프레임 이상 표시됨 = 애니메이션 버벅임

히치가 있는 프레임 (너무 많은 업데이트)

프레임 1:
├─ 이벤트 처리
├─ UI 업데이트
│  ├─ 업데이트 1 (빠름)
│  ├─ 업데이트 2 (빠름)
│  ├─ 업데이트 3 (빠름)
│  ├─ ... (100개의 추가 빠른 업데이트)
│  └─ 총 시간이 마감 시간 초과 ❌
├─ 마감 시간 놓침
└─ 이전 프레임이 계속 표시됨 (히치)

결과: 많은 작은 업데이트가 합쳐져 마감 시간을 놓침

핵심 인사이트: 뷰 바디 실행 시간이 중요한 이유는 프레임 마감 시간을 놓치면 히치가 발생하여 애니메이션이 덜 부드러워지기 때문입니다.

참조:


문제 1: 긴 뷰 바디 업데이트

긴 업데이트 식별

  1. SwiftUI 템플릿으로 Instruments에서 트레이스 기록
  2. 긴 뷰 바디 업데이트 레인 확인 — 주황색/빨간색 막대가 있는가?
  3. SwiftUI 트랙 확장하여 서브트랙 확인
  4. 뷰 바디 업데이트 서브트랙 선택
  5. 긴 업데이트로 필터링:
    • 세부 정보 창 → 드롭다운 → "긴 뷰 바디 업데이트 요약" 선택

Time Profiler로 분석하기

워크플로우:

  1. 긴 뷰 바디 업데이트 요약에서 긴 업데이트 찾기
  2. 뷰 이름 위로 마우스 호버 → 화살표 클릭 → "업데이트 표시"
  3. 긴 업데이트를 마우스 오른쪽 버튼으로 클릭 → "검사 범위 설정 및 확대/축소"
  4. Time Profiler 계측기 트랙으로 전환

보게 될 것:

  • 뷰 바디 실행 중 기록된 샘플의 호출 스택
  • 각 프레임에 소요된 시간 (가장 왼쪽 열)
  • 깊은 SwiftUI 호출 스택에 중첩된 내 뷰 바디

병목 지점 찾기:

  1. Option-클릭하여 메인 스레드 호출 스택 확장
  2. Command-F로 뷰 이름 검색 (예: "LandmarkListItemView")
  3. 시간 열에서 비용이 많이 드는 작업 식별

일반적인 비용이 많이 드는 작업

Formatter 생성 (매우 비용이 큼)

❌ 잘못됨 - 뷰 바디에서 formatter 생성:

struct LandmarkListItemView: View {
    let landmark: Landmark
    @State private var userLocation: CLLocation

    var distance: String {
        // ❌ body가 실행될 때마다 formatter 생성
        let numberFormatter = NumberFormatter()
        numberFormatter.maximumFractionDigits = 1

        let measurementFormatter = MeasurementFormatter()
        measurementFormatter.numberFormatter = numberFormatter

        let meters = userLocation.distance(from: landmark.location)
        let measurement = Measurement(value: meters, unit: UnitLength.meters)
        return measurementFormatter.string(from: measurement)
    }

    var body: some View {
        HStack {
            Text(landmark.name)
            Text(distance) // 비용이 많이 드는 distance 프로퍼티 호출
        }
    }
}

느린 이유:

  • Formatter는 생성 비용이 큼 (각각 밀리초 단위)
  • 뷰 바디가 실행될 때마다 생성됨
  • 메인 스레드에서 실행 → 앱이 UI 업데이트를 계속하기 전에 대기
  • 여러 뷰 → 시간이 빠르게 누적됨

✅ 올바름 - Formatter를 중앙에서 캐싱:

@Observable
class LocationFinder {
    private let formatter: MeasurementFormatter
    private let landmarks: [Landmark]
    private var distanceCache: [Landmark.ID: String] = [:]

    init(landmarks: [Landmark]) {
        self.landmarks = landmarks

        // formatter를 초기화 중에 한 번만 생성
        let numberFormatter = NumberFormatter()
        numberFormatter.maximumFractionDigits = 1

        self.formatter = MeasurementFormatter()
        self.formatter.numberFormatter = numberFormatter

        updateDistances()
    }

    func didUpdateLocations(_ locations: [CLLocation]) {
        guard let location = locations.last else { return }
        updateDistances(from: location)
    }

    private func updateDistances(from location: CLLocation? = nil) {
        guard let location else { return }

        for landmark in landmarks {
            let meters = location.distance(from: landmark.location)
            let measurement = Measurement(value: meters, unit: UnitLength.meters)
            distanceCache[landmark.id] = formatter.string(from: measurement)
        }
    }

    func distanceString(for landmarkID: Landmark.ID) -> String {
        distanceCache[landmarkID] ?? "Unknown"
    }
}

struct LandmarkListItemView: View {
    let landmark: Landmark
    @Environment(LocationFinder.self) private var locationFinder

    var body: some View {
        HStack {
            Text(landmark.name)
            Text(locationFinder.distanceString(for: landmark.id)) // ✅ 빠른 조회
        }
    }
}

이점:

  • Formatter가 한 번 생성되어 모든 랜드마크에 재사용됨
  • 위치가 변경될 때 문자열이 미리 계산됨
  • 뷰 바디는 캐시된 값만 읽음 (즉시)
  • 긴 뷰 바디 업데이트 제거됨

기타 비용이 많이 드는 작업

복잡한 계산:

// ❌ 뷰 바디에서 계산하지 마세요
var body: some View {
    let result = expensiveAlgorithm(data) // 복잡한 수학, 정렬 등
    Text("\(result)")
}

// ✅ 모델에서 계산하고 결과를 캐시하세요
@Observable
class ViewModel {
    private(set) var result: Int = 0

    func updateData(_ data: [Int]) {
        result = expensiveAlgorithm(data) // 한 번 계산
    }
}

네트워크/파일 I/O:

// ❌ 절대로 뷰 바디에서 I/O를 수행하지 마세요
var body: some View {
    let data = try? Data(contentsOf: fileURL) // ❌ 동기 I/O
    // ...
}

// ✅ 비동기적으로 로드

…

[잘림 처리됨]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬