Compétence Expert SwiftUI
Règles de fonctionnement
- Consulter
references/latest-apis.mdau début de chaque tâche pour éviter les API dépréciées. - Privilégier les API SwiftUI natives plutôt que le pont UIKit/AppKit, sauf si nécessaire.
- Se concentrer sur l'exactitude et les performances ; n'imposer aucune architecture spécifique (MVVM, VIPER, etc.).
- Encourager la séparation de la logique métier des vues pour la testabilité sans imposer de méthode particulière.
- Suivre les Human Interface Guidelines et les motifs de conception d'API d'Apple.
- N'adopter Liquid Glass que lorsque l'utilisateur le demande explicitement (voir
references/liquid-glass.md). - Présenter les optimisations de performance comme des suggestions, pas des exigences.
- Utiliser des protections
#availableavec des solutions de repli sensées pour les API spécifiques à une version.
Flux de travail des tâches
Réviser du code SwiftUI existant
- Lire le code en cours de révision et identifier les sujets concernés.
- Signaler les API dépréciées (comparer avec
references/latest-apis.md). - Exécuter le Routeur de sujets ci-dessous pour chaque sujet pertinent.
- Valider les protections
#availableet les chemins de repli pour les fonctionnalités iOS 26+.
Améliorer du code SwiftUI existant
- Auditer l'implémentation actuelle par rapport aux sujets du Routeur de sujets.
- Remplacer les API dépréciées par leurs équivalents modernes issus de
references/latest-apis.md. - Refactoriser les chemins chauds pour réduire les mises à jour d'état inutiles.
- Extraire les corps de vues complexes dans des sous-vues séparées.
- Suggérer un sous-échantillonnage d'image lorsque
UIImage(data:)est rencontré (optimisation facultative, voirreferences/image-optimization.md).
Implémenter une nouvelle fonctionnalité SwiftUI
- Concevoir d'abord le flux de données : identifier l'état possédé par la vue vs l'état injecté.
- Structurer les vues pour un diffing optimal (extraire les sous-vues tôt).
- Appliquer les motifs d'animation corrects (implicite vs explicite, transitions).
- Utiliser
Buttonpour tous les éléments cliquables ; ajouter des groupes d'accessibilité et des étiquettes. - Protéger les API spécifiques à une version avec
#availableet fournir des solutions de repli.
Routeur de sujets
Consulter le fichier de référence pour chaque sujet pertinent à la tâche en cours :
| Sujet | Référence |
|---|---|
| Gestion d'état | references/state-management.md |
| Composition de vues | references/view-structure.md |
| Performances | references/performance-patterns.md |
| Listes et ForEach | references/list-patterns.md |
| Disposition | references/layout-best-practices.md |
| Feuilles et navigation | references/sheet-navigation-patterns.md |
| ScrollView | references/scroll-patterns.md |
| Animations (bases) | references/animation-basics.md |
| Animations (transitions) | references/animation-transitions.md |
| Animations (avancé) | references/animation-advanced.md |
| Accessibilité | references/accessibility-patterns.md |
| Graphiques Swift Charts | references/charts.md |
| Accessibilité des graphiques | references/charts-accessibility.md |
| Optimisation d'images | references/image-optimization.md |
| Liquid Glass (iOS 26+) | references/liquid-glass.md |
| Scènes macOS | references/macos-scenes.md |
| Style des fenêtres macOS | references/macos-window-styling.md |
| Vues macOS | references/macos-views.md |
| Recherche d'API dépréciée | references/latest-apis.md |
Liste de vérification d'exactitude
Ce sont des règles strictes — toute violation est un bogue :
- Les propriétés
@Statesontprivate -
@Bindinguniquement là où un enfant modifie l'état du parent - Les valeurs passées ne sont jamais déclarées comme
@Stateou@StateObject(elles ignorent les mises à jour) -
@StateObjectpour les objets possédés par la vue ;@ObservedObjectpour les objets injectés - iOS 17+ :
@Stateavec@Observable;@Bindablepour les observables injectés nécessitant des liaisons -
ForEachutilise une identité stable (jamais.indicespour du contenu dynamique) - Nombre constant de vues par élément
ForEach -
.animation(_:value:)inclut toujours le paramètrevalue - Les API iOS 26+ sont protégées par
#availableavec une solution de repli fournie -
import Chartsprésent dans les fichiers utilisant des types de graphiques
Références
references/latest-apis.md— À lire en premier pour chaque tâche. Transitions d'API dépréciées vers modernes (iOS 15+ jusqu'à iOS 26+)references/state-management.md— Property wrappers, flux de données, migration@Observablereferences/view-structure.md— Extraction de vues, motifs de conteneurs,@ViewBuilderreferences/performance-patterns.md— Optimisation de chemins chauds, contrôle des mises à jour,_logChanges()references/list-patterns.md— Identité ForEach, Table (iOS 16+), pièges de filtrage en lignereferences/layout-best-practices.md— Motifs de disposition, alternatives à GeometryReaderreferences/accessibility-patterns.md— VoiceOver, Dynamic Type, regroupement, traitsreferences/animation-basics.md— Animations implicites/explicites, minutage, performancesreferences/animation-transitions.md— Transitions de vues,matchedGeometryEffect,Animatablereferences/animation-advanced.md— Animations par phase/images clés (iOS 17+), macro@Animatable(iOS 26+)references/charts.md— Marques Swift Charts, axes, sélection, style, Chart3D (iOS 26+)references/charts-accessibility.md— VoiceOver des graphiques, Audio Graph, stratégies de replireferences/sheet-navigation-patterns.md— Feuilles, NavigationSplitView, Inspecteurreferences/scroll-patterns.md— ScrollViewReader, défilement programmatiquereferences/image-optimization.md— AsyncImage, sous-échantillonnage, mise en cachereferences/liquid-glass.md— Effets Liquid Glass iOS 26+ et motifs de replireferences/macos-scenes.md— Settings, MenuBarExtra, WindowGroup, multi-fenêtrereferences/macos-window-styling.md— Styles de barre d'outils, dimensionnement des fenêtres, Commandsreferences/macos-views.md— HSplitView, Table, PasteButton, interop AppKit