SwiftData 学习笔记：简介及基本使用

简介

SwiftData 是 Apple 新推出的特性，用于数据持久化存储。它允许我们创建自定义对象，定义它们如何链接在一起，通过过滤和排序检索它们，甚至还可以将它们同步到 iCloud。

使用 SwiftData 不仅充分享受 Swift 的最新特性，而且它也是完美适配 SwiftUI的。如果你在项目中使用 SwiftUI ，会发现使用 SwiftData 是非常便利的。

SwiftData 的底层是由一个非常成熟的 Core Data 提供支持的。Core Data 已经经过了近 20 年的发展，使用它进行底层支持是可以使我们享受很多好处。但 SwiftData 并不仅是对 Core Data 的一层简单的封装：Apple 确实全力以赴地隔离和解决了开发人员使用旧框架的关键痛点，这意味着 SwiftData 对于过去使用过 Core Data 的任何人来说都是一个重大改进。

美中不足的是：SwiftData 仅支持 iOS 17 或更高版本，以及其他平台相应版本 - 即 macOS Sonoma、tvOS 17、watchOS 10 和 VisionOS 1.0。

SwiftData 是任何类型的设备存储的绝佳选择，包括：

持久化存储用户数据，例如他们的待办事项列表或者浏览历史记录。
用户数据的临时存储，其中 SwiftData 用作从服务器获取的数据的缓存。
基于文档的 APP，比如文本或者视频编辑器。
复杂的用户设置或者历史数据。

下列情况则不是很好的选择：

需要支持许多使用 iOS 16 及更早版本的用户。尽管 SwiftData 和 Core Data 可以在同一个应用程序中并存，但这会需要额外的工作。
数据仅存储在 CloudKit 或其他同等服务中，并且需要始终使用实时数据。
需要 Core Data 提供的全方位功能。 Core Data 的许多功能尚未在 SwiftData 中体现，因此如果你有更高级的用例，你可能应该继续使用 Core Data。

基本使用

对于 SwiftUI 来说，使用 SwiftData 还是非常简单的。假设我们有一个代表时间戳的类：Item，代码如下:

final class Item {
    var timestamp: Date
    
    init(timestamp: Date) {
        self.timestamp = timestamp
    }
}

我们需要下面这几步来使用 SwiftData，首先导入该框架，在类的前面加上 @Model 的宏：

import SwiftData

@Model
final class Item {
    var timestamp: Date
    
    init(timestamp: Date) {
        self.timestamp = timestamp
    }
}

这样，就完成了关于模型的改造。接下来就是使用它。我们需要在 APP 入口结构体中配置它:

var sharedModelContainer: ModelContainer = {
        let schema = Schema([
            Item.self
        ])
        let modelConfiguration = ModelConfiguration(schema: schema, isStoredInMemoryOnly: false)

        do {
            return try ModelContainer(for: schema, configurations: [modelConfiguration])
        } catch {
            fatalError("Could not create ModelContainer: \(error)")
        }
    }()

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .modelContainer(sharedModelContainer)
    }

我们看到上面的代码主要做了两件事：

配置 ModelContainer，这里的作用就是告诉系统我要数据持久化 Item。
使用 modelContainer 修饰符，告诉系统整个应用程序都会使用该模型。

这样，我们完成了 Item 的持久化的准备工作，接下来就是具体的增删改查了。代码示例：

// 获取模型环境变量的上下文
@Environment(\.modelContext) private var modelContext
// 插入
private func addItem() {
    let newItem = Item(timestamp: Date())
    modelContext.insert(newItem)
}