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,代码如下:

swift 复制代码
final class Item {
    var timestamp: Date
    
    init(timestamp: Date) {
        self.timestamp = timestamp
    }
}

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

swift 复制代码
import SwiftData

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

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

swift 复制代码
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 的持久化的准备工作,接下来就是具体的增删改查了。代码示例:

typescript 复制代码
// 获取模型环境变量的上下文
@Environment(\.modelContext) private var modelContext
// 插入
private func addItem() {
    let newItem = Item(timestamp: Date())
    modelContext.insert(newItem)
}
相关推荐
CocoaKier6 小时前
苹果开发者注意,请在2027年1月31日前完成合规验证,否则中国区可能下架
ios·aigc·apple
二流小码农10 小时前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
bcbnb10 小时前
Windows 上 iOS 开发接 CI,KXBuild 自托管 runner 出签名 ipa
后端·ios
疯华整猫17 小时前
别再抄 Flutter 了:2026 年 Android / iOS / 小程序跨端架构选型的四本成本账
android·前端·ios
黑科技iOS上架17 小时前
iOS游戏换皮上架困境:4.3同质化拒审
人工智能·ios·审核
黑科技iOS上架17 小时前
iOS二次开发应用上架难题:4.3a同质化拒审
ios·审核
传奇开心果编程17 小时前
【Flutter踩坑排雷】第30课:异常未捕获坑|未捕获异常直接闪退,全局兜底故障处理
android·flutter·ios·移动开发·dart·ui框架·声明式ui
茶底世界之下17 小时前
海边游乐场的黄昏:用 Awaking 留住一层暖光
ios·app·产品
90后的晨仔1 天前
Xcode 27.1 下,老工程如何在 iPhone Duo 模拟器上跑起来
ios
90后的晨仔1 天前
Xcode 27 升级后满屏 deployment target 报错?一文搞定
ios