Swift 数据库 - 快速持久化对象和用于 iOS 和 macOS 的设备内向量数据库

强大且超快速的 Swift 数据库，同时易于使用。在 iOS 和 macOS 上快速可靠地持久化 Swift 对象。

示例代码

// objectbox: entity
class Person {
    var id: Id = 0
    var firstName: String = ""
    var lastName: String = ""
    
    init() {}
    
    init(id: Id = 0, firstName: String, lastName: String) {
        self.id = id
        self.firstName = firstName
        self.lastName = lastName
    }
}

let store = try Store(directoryPath: "person-db")
let box = store.box(for: Person.self)

var person = Person(firstName: "Joe", lastName: "Green")
let id = try box.put(person) // 创建

person = try box.get(id)!    // 读取

person.lastName = "Black"
try box.put(person)          // 更新

try box.remove(person.id)    // 删除

let query = try box.query {  // 查询
    Person.firstName == "Joe"
    && Person.lastName.startsWith("B")
}.build()
let people: [Person] = try query.find()

想了解详情？阅读指南 或 查看 API 文档。

为什么使用 ObjectBox 进行 Swift 数据持久化？

简单但强大；节俭但快速：ObjectBox NoSQL 数据库提供了直观的 Swift API，易于上手，使用愉快，速度极快，在多个方面都具有可持续性。其节俭的资源使用（CPU、内存、电池/电源）使 ObjectBox 成为 iOS 应用的理想和可持续选择。那么为什么不立即尝试一下呢？查看下面的安装部分。您也可以为这个仓库加星标以便日后使用 🌟

特性

🧠 人工智能 - 超快速设备内向量搜索。
🏁 在受限设备上高性能，如物联网网关、微控制器、ECU 等。
💚 资源节约，最小化 CPU、电源和内存使用，实现最大灵活性和可持续性
🔗 关系： 内置对象链接/关系
💻 多平台： Linux、Windows、Android、iOS、macOS

🌱 可扩展： 轻松高效地处理数百万对象
💐 查询： 根据需要过滤数据，甚至跨关系
🦮 静态类型： 编译时检查和优化
📃 自动架构迁移： 无需更新脚本

不仅仅是数据持久化
👥 ObjectBox Sync： 保持设备和服务器之间的数据同步
🕒 ObjectBox TS： 用于基于时间的数据的时间序列扩展

<a name="cocoapods"></a>将 ObjectBox 添加到您的项目

ObjectBox 可通过 CocoaPods pod 获得。查看文档了解详细信息和其他设置选项。

如果您不熟悉 CocoaPods，请查看他们的网站获取介绍和安装说明。

要添加 ObjectBox Swift 依赖，请在您的 Podfile 中添加以下行：

  pod 'ObjectBox'

然后在您的项目目录中运行以下命令以安装 ObjectBox 框架：

pod install --repo-update
Pods/ObjectBox/setup.rb

然后打开您的 Xcode 工作空间（.xcworkspace）而不是 Xcode 项目（.xcodeproj）。现在，您已经准备好定义您的第一个ObjectBox实体了；例如，请查看入门指南或下面描述的示例。

CocoaPods故障排除

如果pod install失败，请先尝试更新CocoaPods：

gem update xcodeproj && gem update cocoapods && pod repo update

更新到较新的ObjectBox版本

更新ObjectBox pod并重新运行设置脚本：

pod repo update
pod update ObjectBox
Pods/ObjectBox/setup.rb

<a name="example"></a>示例

在Example目录中，您会找到一个"Notes"示例应用，演示了ObjectBox的Swift API。该示例包含两个应用：一个用于iOS，另一个用于macOS。iOS示例是一个完整的GUI应用程序，而macOS示例运行几个操作后就退出。

Swift版本

以下是ObjectBox发布版本及其编译使用的Swift版本列表：

ObjectBox版本	Swift版本
4.0.0	5.9
2.0.0	5.9
1.9.2	5.9
1.9.1	5.9
1.9.0	5.8.1
1.8.1	5.7.2
1.8.0	5.7.1
1.7.0	5.5
1.6.0	5.4
1.5.0	5.3(.2)
1.4.1	5.3
1.3, 1.4.0	5.2
1.2	5.1

这可能会有相关性，例如在使用Carthage时。出于各种原因，我们建议使用最新版本。

开发

ObjectBox Swift绑定的源代码可以在本仓库的Source文件夹中找到。

背景：代码生成

ObjectBox Swift数据库在构建时生成代码，以在运行时获得最佳性能，避免使用反射等。这个过程会自动为您完成，应该是透明的。在内部，我们使用Sourcery的一个分支来实现这一点。

已经在使用ObjectBox了吗？

我们的使命是为应用程序开发者带来快乐、愉悦和可持续性。**为此，我们需要您的帮助：**请填写这份2分钟的匿名反馈表。让我们知道您喜欢什么，以及哪些地方需要改进，以便我们能够提升。

我们期待收到您的评论和请求：

添加GitHub问题
通过点击👍/+1反应按钮为您认为重要的问题投票
通过@ObjectBox_io给我们留言
如果您喜欢我们的项目，请给我们⭐

非常感谢！🙏

保持联系：关于ObjectBox的一般新闻，请查看我们的博客！

跨平台数据库：移动、桌面、浏览器、嵌入式、物联网

ObjectBox是一个支持多种原生语言的可持续应用程序开发的跨平台数据库：

Flutter/Dart数据库：持久化Dart对象并使用Flutter构建跨平台应用。
C和C++数据库：在嵌入式设备上实现原生速度，零拷贝访问对象。
Java/Kotlin数据库：运行在Android、桌面和服务器上。
Golang数据库：非常适合物联网、数据驱动工具和服务器应用。也可用于将ObjectBox移植到其他语言。

许可证

Copyright 2018-2024 ObjectBox Ltd. 保留所有权利。

根据Apache许可证2.0版（"许可证"）授权；
除非遵守许可证，否则您不得使用此文件。
您可以在以下位置获取许可证的副本

    http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据许可证分发的软件
是基于"按原样"分发的，不附带任何明示或暗示的保证或条件。
有关许可证下特定语言的权限和限制，请参阅许可证。

请注意，此许可证仅适用于本仓库中的代码。有关ObjectBox组件的所有许可证详情，请参阅我们的网站。