SwiftUI Expert Skill
Betriebsregeln
- Lies zu Beginn jeder Aufgabe
references/latest-apis.md, um veraltete APIs zu vermeiden. - Bevorzuge native SwiftUI-APIs gegenüber UIKit/AppKit-Brücken, es sei denn, die Brücke ist notwendig.
- Konzentriere dich auf Korrektheit und Performance; schreibe keine bestimmte Architektur (MVVM, VIPER usw.) vor.
- Fördere die Trennung von Geschäftslogik und Views für die Testbarkeit, ohne eine bestimmte Methode vorzuschreiben.
- Folge den Human Interface Guidelines und API-Entwurfsmustern von Apple.
- Übernehme Liquid Glass nur, wenn der Benutzer es explizit anfordert (siehe
references/liquid-glass.md). - Präsentiere Performance-Optimierungen als Vorschläge, nicht als Anforderungen.
- Verwende
#available-Gates mit sinnvollen Fallbacks für versionsspezifische APIs.
Aufgaben-Workflow
Bestehenden SwiftUI-Code überprüfen
- Lese den zu überprüfenden Code und identifiziere, welche Themen zutreffen.
- Markiere veraltete APIs (Vergleich mit
references/latest-apis.md). - Führe den Topic Router für jedes relevante Thema aus.
- Validiere
#available-Gates und Fallback-Pfade für iOS 26+-Features.
Bestehenden SwiftUI-Code verbessern
- Überprüfe die aktuelle Implementierung anhand der Topic Router-Themen.
- Ersetze veraltete APIs durch moderne Äquivalente aus
references/latest-apis.md. - Refaktoriere heiße Pfade, um unnötige Statusaktualisierungen zu reduzieren.
- Extrahiere komplexe View-Körper in separate Unterviews.
- Schlage Bild-Downsampling vor, wenn
UIImage(data:)verwendet wird (optionale Optimierung, siehereferences/image-optimization.md).
Neue SwiftUI-Features implementieren
- Entwerfe zuerst den Datenfluss: identifiziere eigenen vs. injizierten Zustand.
- Strukturiere Views für optimales Diffing (extrahiere Unterviews frühzeitig).
- Wende korrekte Animationsmuster an (implizit vs. explizit, Übergänge).
- Verwende
Buttonfür alle antippbaren Elemente; füge Accessibility-Gruppierung und -Beschriftungen hinzu. - Gate versionsspezifische APIs mit
#availableund stelle Fallbacks bereit.
Topic Router
Konsultiere die Referenzdatei für jedes Thema, das für die aktuelle Aufgabe relevant ist:
| Thema | Referenz |
|---|---|
| State Management | references/state-management.md |
| View-Komposition | references/view-structure.md |
| Performance | references/performance-patterns.md |
| Listen und ForEach | references/list-patterns.md |
| Layout | references/layout-best-practices.md |
| Sheets und Navigation | references/sheet-navigation-patterns.md |
| ScrollView | references/scroll-patterns.md |
| Animationen (Grundlagen) | references/animation-basics.md |
| Animationen (Übergänge) | references/animation-transitions.md |
| Animationen (fortgeschritten) | references/animation-advanced.md |
| Accessibility | references/accessibility-patterns.md |
| Swift Charts | references/charts.md |
| Charts Accessibility | references/charts-accessibility.md |
| Bildoptimierung | references/image-optimization.md |
| Liquid Glass (iOS 26+) | references/liquid-glass.md |
| macOS-Szenen | references/macos-scenes.md |
| macOS-Fensterstyling | references/macos-window-styling.md |
| macOS-Views | references/macos-views.md |
| Veraltete API-Suche | references/latest-apis.md |
Korrektheits-Checkliste
Dies sind harte Regeln – Verstöße sind immer Fehler:
-
@State-Eigenschaften sindprivate -
@Bindingnur dort, wo ein Kind den Elternzustand ändert - Übergebene Werte werden nie als
@Stateoder@StateObjectdeklariert (sie ignorieren Aktualisierungen) -
@StateObjectfür view-eigene Objekte;@ObservedObjectfür injizierte - iOS 17+:
@Statemit@Observable;@Bindablefür injizierte Observablen, die Bindungen benötigen -
ForEachverwendet stabile Identität (niemals.indicesfür dynamische Inhalte) - Konstante Anzahl von Views pro
ForEach-Element -
.animation(_:value:)enthält immer denvalue-Parameter - iOS 26+-APIs mit
#availablegegated und Fallback bereitgestellt -
import Chartsin Dateien vorhanden, die Chart-Typen verwenden
Referenzen
references/latest-apis.md– Jede Aufgabe zuerst lesen. Veraltete-zu-modernen API-Übergänge (iOS 15+ bis iOS 26+)references/state-management.md– Property Wrapper, Datenfluss,@Observable-Migrationreferences/view-structure.md– View-Extraktion, Container-Muster,@ViewBuilderreferences/performance-patterns.md– Hot-Path-Optimierung, Update-Steuerung,_logChanges()references/list-patterns.md– ForEach-Identität, Table (iOS 16+), Inline-Filter-Fallstrickereferences/layout-best-practices.md– Layout-Muster, GeometryReader-Alternativenreferences/accessibility-patterns.md– VoiceOver, Dynamic Type, Gruppierung, Eigenschaftenreferences/animation-basics.md– Implizite/explizite Animationen, Timing, Performancereferences/animation-transitions.md– View-Übergänge,matchedGeometryEffect,Animatablereferences/animation-advanced.md– Phasen-/Keyframe-Animationen (iOS 17+),@Animatable-Makro (iOS 26+)references/charts.md– Swift Charts Marks, Achsen, Auswahl, Styling, Chart3D (iOS 26+)references/charts-accessibility.md– Charts-VoiceOver, Audio-Graph, Fallback-Strategienreferences/sheet-navigation-patterns.md– Sheets, NavigationSplitView, Inspectorreferences/scroll-patterns.md– ScrollViewReader, programmatisches Scrollenreferences/image-optimization.md– AsyncImage, Downsampling, Cachingreferences/liquid-glass.md– iOS 26+ Liquid Glass-Effekte und Fallback-Musterreferences/macos-scenes.md– Settings, MenuBarExtra, WindowGroup, Multi-Fensterreferences/macos-window-styling.md– Toolbar-Stile, Fenstergröße, Commandsreferences/macos-views.md– HSplitView, Table, PasteButton, AppKit-Interop