SwiftUI Performance Audit
Überblick
Überprüfe die SwiftUI-View-Performance von Anfang bis Ende – von der Instrumentierung und Ausgangsmessung über die Ursachenanalyse bis hin zu konkreten Korrekturschritten.
Workflow-Entscheidungsbaum
- Wenn der Benutzer Code bereitstellt, beginne mit der „Code-zentrierten Überprüfung“.
- Wenn der Benutzer nur Symptome beschreibt, fordere minimalen Code/Kontext an und führe dann die „Code-zentrierte Überprüfung“ durch.
- Wenn die Code-Überprüfung nicht schlüssig ist, leite den Benutzer zur Profilerstellung an und bitte um einen Trace oder Screenshots.
1. Code-zentrierte Überprüfung
Erhebe:
- Code der Ziel-View/des Features.
- Datenfluss: State, Environment, Observable-Modelle.
- Symptome und Reproduktionsschritte.
Konzentriere dich auf:
- View-Invalidierungsstürme durch breite State-Änderungen.
- Instabile Identität in Listen (
id-Wechsel,UUID()pro Render). - Schwere Arbeit in
body(Formatierung, Sortierung, Bilddecodierung). - Layout-Thrashing (tiefe Stacks,
GeometryReader, Preference-Chains). - Große Bilder ohne Downsampling oder Größenanpassung.
- Überanimierte Hierarchien (implizite Animationen auf großen Bäumen).
Liefere:
- Wahrscheinliche Ursachen mit Code-Referenzen.
- Vorgeschlagene Korrekturen und Refactorings.
- Bei Bedarf ein minimales Reproduktionsbeispiel oder einen Instrumentierungsvorschlag.
2. Benutzer zur Profilerstellung anleiten
Erkläre, wie Daten mit Instruments erfasst werden:
- Verwende die SwiftUI-Vorlage in Instruments (Release-Build).
- Reproduziere die exakte Interaktion (Scrollen, Navigation, Animation).
- Erfasse die SwiftUI-Zeitleiste und den Time Profiler.
- Exportiere oder mache Screenshots der relevanten Spuren und des Aufrufbaums.
Bitte um:
- Trace-Export oder Screenshots der SwiftUI-Spuren + des Time-Profiler-Aufrufbaums.
- Geräte-/OS-/Build-Konfiguration.
3. Analysieren und Diagnostizieren
Priorisiere die wahrscheinlichen SwiftUI-Übeltäter:
- View-Invalidierungsstürme durch breite State-Änderungen.
- Instabile Identität in Listen (
id-Wechsel,UUID()pro Render). - Schwere Arbeit in
body(Formatierung, Sortierung, Bilddecodierung). - Layout-Thrashing (tiefe Stacks,
GeometryReader, Preference-Chains). - Große Bilder ohne Downsampling oder Größenanpassung.
- Überanimierte Hierarchien (implizite Animationen auf großen Bäumen).
Fasse die Ergebnisse mit Nachweisen aus Traces/Logs zusammen.
4. Behebung
Wende gezielte Korrekturen an:
- Eingrenzung des State-Scopes (
@State/@Observablenäher an Leaf-Views). - Stabilisiere Identitäten für
ForEachund Listen. - Verlege schwere Arbeit aus
body(vorberechnen, cachen,@State). - Verwende
equatable()oder Wert-Wrapper für teure Subtrees. - Downsample Bilder vor dem Rendern.
- Reduziere Layout-Komplexität oder verwende feste Größen, wo möglich.
Häufige Code-Gerüche (und Korrekturen)
Achte bei Code-Reviews auf diese Muster.
Teure Formatierer in body
var body: some View {
let number = NumberFormatter() // langsame Allokation
let measure = MeasurementFormatter() // langsame Allokation
Text(measure.string(from: .init(value: meters, unit: .meters)))
}
Bevorzuge gecachte Formatierer in einem Modell oder einem dedizierten Helfer:
final class DistanceFormatter {
static let shared = DistanceFormatter()
let number = NumberFormatter()
let measure = MeasurementFormatter()
}
Berechnete Eigenschaften mit schwerer Arbeit
var filtered: [Item] {
items.filter { $0.isEnabled } // läuft bei jeder body-Auswertung
}
Bevorzuge Vorberechnung oder Caching bei Änderungen:
@State private var filtered: [Item] = []
// aktualisiere filtered, wenn sich die Eingaben ändern
Sortieren/ Filtern in body oder ForEach
List {
ForEach(items.sorted(by: sortRule)) { item in
Row(item)
}
}
Bevorzuge einmaliges Sortieren vor View-Updates:
let sortedItems = items.sorted(by: sortRule)
Inline-Filtern in ForEach
ForEach(items.filter { $0.isEnabled }) { item in
Row(item)
}
Bevorzuge eine vorab gefilterte Sammlung mit stabiler Identität.
Instabile Identität
ForEach(items, id: \.self) { item in
Row(item)
}
Vermeide id: \.self für nicht stabile Werte; verwende eine stabile ID.
Bilddecodierung im Hauptthread
Image(uiImage: UIImage(data: data)!)
Bevorzuge Decodieren/Downsampling außerhalb des Hauptthreads und speichere das Ergebnis.
Breite Abhängigkeiten in Observable-Modellen
@Observable class Model {
var items: [Item] = []
}
var body: some View {
Row(isFavorite: model.items.contains(item))
}
Bevorzuge granulare View-Modelle oder Status pro Element, um Update-Fan-Out zu reduzieren.
5. Verifizierung
Bitte den Benutzer, die gleiche Aufnahme erneut durchzuführen und mit den Ausgangsmesswerten zu vergleichen. Fasse die Differenz zusammen (CPU, Frame-Drops, Speicherspitze), falls vorhanden.
Ergebnisse
Liefere:
- Eine kurze Metrik-Tabelle (vorher/nachher, falls verfügbar).
- Die wichtigsten Probleme (geordnet nach Auswirkung).
- Vorgeschlagene Korrekturen mit geschätztem Aufwand.
Referenzen
Füge Apple-Dokumentation und WWDC-Ressourcen unter references/ hinzu, sofern sie vom Benutzer bereitgestellt werden.
- Optimieren der SwiftUI-Leistung mit Instruments:
references/optimizing-swiftui-performance-instruments.md - Verstehen und Verbessern der SwiftUI-Leistung:
references/understanding-improving-swiftui-performance.md - Verstehen von Hängern in Ihrer App:
references/understanding-hangs-in-your-app.md - Entmystifizierung der SwiftUI-Leistung (WWDC23):
references/demystify-swiftui-performance-wwdc23.md