Migraciones y sincronización con CloudKit

Una app viva cambia: añades campos, renombras, reorganizas. Y los datos de tus usuarios deben sobrevivir a esos cambios. Además, hoy se espera que todo se sincronice entre iPhone, iPad y Mac. SwiftData cubre ambas cosas con relativamente poco esfuerzo.

Migraciones ligeras

Si añades una propiedad con valor por defecto, o una nueva opcional, SwiftData migra solo el almacén existente sin que hagas nada:

@Model
class Tarea {
    var titulo: String
    var completada = false
    var prioridad: Int = 0     // campo nuevo con default → migración automática
}

Los usuarios que ya tenían datos los conservan; el campo nuevo aparece con su valor por defecto. La mayoría de los cambios cotidianos entran aquí.

Migraciones personalizadas

Para cambios complejos (renombrar, dividir un campo, transformar valores), defines esquemas versionados y un plan de migración:

enum EsquemaV1: VersionedSchema {
    static var versionIdentifier = Schema.Version(1, 0, 0)
    static var models: [any PersistentModel.Type] { [Tarea.self] }
}

enum PlanMigracion: SchemaMigrationPlan {
    static var schemas: [any VersionedSchema.Type] { [EsquemaV1.self, EsquemaV2.self] }
    static var stages: [MigrationStage] {
        [.custom(fromVersion: EsquemaV1.self, toVersion: EsquemaV2.self,
                 willMigrate: nil, didMigrate: { context in
            // transforma los datos aquí
        })]
    }
}

Sincronizar con CloudKit

Para que los datos viajen entre los dispositivos del usuario vía iCloud, SwiftData se integra con CloudKit casi automáticamente. En Xcode: activa la capacidad iCloud → CloudKit y usa un contenedor con configuración de sync. A menudo basta con:

.modelContainer(for: Tarea.self)   // detecta iCloud si está configurado

Y los datos aparecen en el iPad, el Mac y el iPhone del mismo usuario, sin servidor propio.