SwiftUI パフォーマンス監査
クレジット: @Dimillian の Dimillian/Skills(2025-12-31)より引用。
概要
SwiftUI ビューのパフォーマンスを、インストルメンテーションとベースライン測定から根本原因分析、具体的な修正手順までエンドツーエンドで監査します。
ワークフロー決定木
- ユーザーがコードを提供した場合:"コードファーストレビュー"から開始。
- ユーザーが症状のみを説明した場合:最小限のコード/コンテキストを求め、その後"コードファーストレビュー"を実施。
- コードレビューで結論が出ない場合:"ユーザーをプロファイリングへ導く"に進み、トレースまたはスクリーンショットを依頼。
1. コードファーストレビュー
収集するもの:
- 対象のビュー/機能のコード。
- データフロー:state、environment、observable モデル。
- 症状と再現手順。
着目する点:
- 広範な状態変更によるビュー無効化ストーム。
- リスト内の不安定な Identity(
idの変動、レンダリングごとのUUID())。 body内での重い処理(フォーマット、ソート、画像デコード)。- レイアウトスラッシング(深い階層、
GeometryReader、優先度チェーン)。 - ダウンサンプリングやリサイズなしの大きな画像。
- アニメーションの過剰な階層(大きいビューツリーへの暗黙的アニメーション)。
提供するもの:
- コード参照を含む推定される根本原因。
- 修正案とリファクタリングの提案。
- 必要に応じて、最小限の再現コードやインストルメンテーションの提案。
2. ユーザーをプロファイリングへ導く
Instruments でデータを収集する方法を説明します:
- Instruments の SwiftUI テンプレートを使用(Release ビルド)。
- 正確な操作(スクロール、ナビゲーション、アニメーション)を再現。
- SwiftUI タイムラインと Time Profiler をキャプチャ。
- 関連するレーンとコールツリーをエクスポートまたはスクリーンショット。
依頼するもの:
- SwiftUI レーン + Time Profiler コールツリーのトレースエクスポートまたはスクリーンショット。
- デバイス/OS/ビルド構成。
3. 分析と診断
SwiftUI の一般的な原因を優先:
- 広範な状態変更によるビュー無効化ストーム。
- リスト内の不安定な Identity(
idの変動、レンダリングごとのUUID())。 body内での重い処理(フォーマット、ソート、画像デコード)。- レイアウトスラッシング(深い階層、
GeometryReader、優先度チェーン)。 - ダウンサンプリングやリサイズなしの大きな画像。
- アニメーションの過剰な階層(大きいビューツリーへの暗黙的アニメーション)。
トレースやログからの証拠を基に調査結果をまとめます。
4. 修正
的を絞った修正を適用:
- 状態のスコープを狭くする(
@State/@Observableをリーフビューの近くに配置)。 ForEachやリストの identity を安定化。- 重い処理を
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()
}
重い処理を行う computed プロパティ
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)
}
}
ビュー更新の前に1回だけソートすることを推奨:
let sortedItems = items.sorted(by: sortRule)
ForEach でのインラインフィルタリング
ForEach(items.filter { $0.isEnabled }) { item in
Row(item)
}
安定した identity を持つ事前フィルタリングされたコレクションを推奨。
不安定な identity
ForEach(items, id: \.self) { item in
Row(item)
}
安定しない値には id: \.self を避け、安定した ID を使用。
メインスレッドでの画像デコード
Image(uiImage: UIImage(data: data)!)
メインスレッド外でデコード/ダウンサンプリングし、結果を保存することを推奨。
Observable モデル内の広範な依存関係
@Observable class Model {
var items: [Item] = []
}
var body: some View {
Row(isFavorite: model.items.contains(item))
}
粒度の細かいビューモデルやアイテムごとの状態を使用して、更新の波及を減らすことを推奨。
5. 検証
ユーザーに同じキャプチャを再実行し、ベースラインのメトリクスと比較するよう依頼します。 提供された場合、デルタ(CPU、フレームドロップ、メモリピーク)を要約します。
出力
以下のものを提供します:
- 短いメトリクス表(可能であれば改善前/後)。
- 主要な問題(影響度順)。
- 推定作業量を含む修正案。
参照資料
ユーザーから提供された Apple ドキュメントや WWDC リソースは references/ 以下に追加してください。
- SwiftUI パフォーマンスを Instruments で最適化:
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