SwiftData : Le Guide Ultime de iOS 17 à iOS 26

SwiftData est un framework de persistance déclaratif qui permet de modéliser et stocker les données de votre application en Swift pur. Il utilise les macros Swift pour transformer des classes ordinaires en modèles persistants, éliminant le besoin de fichiers .xcdatamodeld et de génération de code.

Les caractéristiques principales :

SwiftData n'est pas un remplacement complet de Core Data, mais plutôt une nouvelle API construite sur ses fondations. Le format de stockage par défaut reste compatible avec Core Data.

Pour les nouveaux projets ciblant iOS 17+, SwiftData est recommandé. Pour les projets existants ou nécessitant des fonctionnalités avancées (batch operations, faulting), Core Data reste pertinent.

Lancement initial avec les fondamentaux :

Évolution majeure de l'architecture :

Stabilisation et nouvelles fonctionnalités :

Transformer une classe en modèle persistant ne nécessite qu'une ligne :

La macro @Model génère automatiquement la conformité à PersistentModel et Observable, permettant à SwiftUI de réagir aux changements.

Le ModelContainer gère le stockage persistant, tandis que le ModelContext représente l'espace de travail pour les opérations CRUD :

Le modifier .modelContainer configure automatiquement le conteneur et injecte le contexte dans l'environnement SwiftUI.

Pour plus de contrôle, créez le container manuellement :

La macro @Query transforme les requêtes en propriétés réactives :

Les paramètres de @Query permettent le tri, le filtrage et la limitation :

Les opérations de base s'effectuent via le ModelContext :

SwiftData supporte nativement :

La macro @Attribute permet de configurer le comportement de persistance :

SwiftData supporte les relations one-to-one, one-to-many et many-to-many :

Les règles de suppression disponibles :

Pour les propriétés calculées ou temporaires :

Pour les requêtes en dehors de SwiftUI, utilisez FetchDescriptor :

La macro #Predicate offre un filtrage compilé et type-safe :

Combinez plusieurs conditions avec les opérateurs logiques :

La macro #Expression permet d'effectuer des calculs directement dans les requêtes :

La macro #Unique garantit l'unicité et effectue des upserts automatiques :

Lors de l'insertion d'un Trip avec les mêmes name/startDate/endDate, SwiftData effectue une mise à jour au lieu de créer un doublon.

Créez des index sur les propriétés fréquemment filtrées ou triées :

Pour conserver des valeurs après suppression (utile pour l'History API) :

Encapsulez chaque version de votre schéma :

Définissez l'ordre des migrations et les étapes custom :

Pour les transformations complexes :

Si votre app est déjà en production sans VersionedSchema :

Activez iCloud dans votre projet et configurez le container :

Options de base de données CloudKit :

CloudKit avec SwiftData a des contraintes :

Activez les logs pour diagnostiquer :

@Query et ModelContext s'exécutent sur le MainActor. Pour des opérations lourdes, cela bloque l'UI :

Créez un actor dédié pour les opérations lourdes :

Les modèles ne sont pas Sendable. Utilisez leurs identifiants :

L'historique est activé par défaut avec DefaultStore. Utilisez preserveValueOnDeletion pour conserver les identifiants des éléments supprimés :

iOS 18 permet de remplacer le backend SQLite par n'importe quel système de stockage via le protocole DataStore :

Exemple simplifié d'un store basé sur JSON :

L'héritage est approprié quand :

Utilisez le mot-clé is dans les prédicats :

SwiftData stocke tous les sous-types dans une seule table (Wide Table). Cela peut impacter les performances avec beaucoup de sous-classes différentes, des propriétés très différentes entre sous-classes, ou des volumes de données importants.

Pour les hiérarchies complexes, préférez la composition avec des relations.

Ajoutez ces arguments dans votre scheme (Edit Scheme → Arguments) :

Localisez et inspectez le fichier de données :

Isolez SwiftData derrière une abstraction :

Créez un container de preview dédié :

Avant iOS 26, les modifications via @ModelActor ne déclenchaient pas toujours les updates SwiftUI :

iOS 26 corrige ce bug de manière rétrocompatible jusqu'à iOS 17.

Avant iOS 26, utiliser des propriétés Codable dans les predicates ne fonctionnait pas :

Bug connu : .cascade ne supprime pas toujours les enfants :

Possible mais complexe. Les identifiants ne sont pas compatibles. Approche recommandée : migration progressive — garder Core Data pour les features critiques, nouveaux modèles en SwiftData, migrer progressivement quand SwiftData mature.

SwiftData représente l'avenir de la persistance sur les plateformes Apple. Malgré une jeunesse qui se traduit par quelques limitations, le framework évolue rapidement et devient de plus en plus viable pour les applications en production. En maîtrisant les concepts de ce guide, vous êtes prêt à l'adopter sereinement dans vos projets.