SwiftUI パフォーマンス監査
概要
SwiftUIビューのパフォーマンスをエンドツーエンドで監査します。計装とベースライン設定から根本原因分析、具体的な改善手順までをカバーします。
ワークフロー判断ツリー
- ユーザーがコードを提供した場合は、「コードファーストレビュー」から開始します。
- ユーザーが症状のみを説明する場合は、最小限のコード/コンテキストを求め、その後「コードファーストレビュー」を実施します。
- コードレビューで結論が出ない場合は、「ユーザーにプロファイリングをガイド」に進み、トレースまたはスクリーンショットを依頼します。
1. コードファーストレビュー
収集するもの:
- 対象のビュー/機能のコード。
- データフロー: state、environment、observableモデル。
- 症状と再現手順。
重点的に確認する点:
- 広範な状態変更によるビューの無効化ストーム。
- リスト内の不安定な同一性(
idの変動、描画ごとのUUID()生成)。 body内の重い処理(フォーマット、ソート、画像デコード)。- レイアウトスラッシュ(深いスタック、
GeometryReader、preferenceチェーン)。 - ダウンサンプリングやリサイズを行わない大きな画像。
- 過剰なアニメーションハイラルキー(大きなツリーへの暗黙的アニメーション)。
提供するもの:
- コード参照を含む可能性の高い根本原因。
- 提案された修正とリファクタリング。
- 必要に応じて、最小限の再現コードや計装の提案。
2. ユーザーにプロファイリングをガイド
Instrumentsでデータを収集する方法を説明します:
- InstrumentsのSwiftUIテンプレートを使用します(Releaseビルド)。
- 問題の操作(スクロール、ナビゲーション、アニメーション)を正確に再現します。
- SwiftUIタイムラインとTime Profilerをキャプチャします。
- 該当するレーンとコールツリーをエクスポートまたはスクリーンショットします。
依頼するもの:
- トレースのエクスポート、またはSwiftUIレーンとTime Profilerのコールツリーのスクリーンショット。
- デバイス/OS/ビルド設定。
3. 分析と診断
可能性の高いSwiftUIの原因を優先順位付けします:
- 広範な状態変更によるビューの無効化ストーム。
- リスト内の不安定な同一性(
idの変動、描画ごとのUUID()生成)。 body内の重い処理(フォーマット、ソート、画像デコード)。- レイアウトスラッシュ(深いスタック、
GeometryReader、preferenceチェーン)。 - ダウンサンプリングやリサイズを行わない大きな画像。
- 過剰なアニメーションハイラルキー(大きなツリーへの暗黙的アニメーション)。
トレース/ログからの証拠を基に、調査結果を要約します。
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()
}
重い処理を行う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)
}
}
ビュー更新の前に一度だけソートします:
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モデル内での広範な依存関係
@Observable class Model {
var items: [Item] = []
}
var body: some View {
Row(isFavorite: model.items.contains(item))
}
更新のファンアウトを減らすために、粒度の細かいビューモデルまたはアイテムごとの状態を優先します。
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