适用于 Swift 的 Atlas Device SDK

Atlas Device SDK 已弃用。有关详细信息，请参阅弃用页面。

使用 Atlas Device SDK for Swift 来开发 Swift 和 Objective-C 语言的 iOS、macOS、watchOS 和 tvOS 应用程序。

学习路径

开始使用 Swift SDK

快速入门

关于如何使用 Swift SDK 的最简单易懂的代码示例。写入设备数据库，并与其他设备同步。

查看代码示例

有效示例应用

剖析一个使用 Swift SDK 的可运行的 SwiftUI 客户端应用程序，从示例中学习。

探索示例应用

导引式教程

通过导引式教程，学习如何调整示例应用以创建自己的可运行的应用程序。

按照教程执行

您能做什么

使用 SDK 开发应用程序

使用 SDK 的开源数据库 Realm 作为设备上的对象存储。使用 Device Sync 使数据与 MongoDB Atlas 集群以及其他客户端保持同步。

安装 Swift SDK

使用 Swift Package Manager、CocoaPods 或 Carthage 在项目中安装适用于 iOS、macOS、tvOS 和 watchOS 的 SDK。

在项目文件中导入 RealmSwift以开始使用。

定义对象模式

使用 Swift 以惯用方式定义对象模式。

打开数据库

SDK 的数据库 Realm 将对象存储在设备上的文件中。或者，您也可以打开不创建文件的内存中数据库。配置并打开数据库，为数据库文件指定选项。

读取和写入数据

创建、读取、更新和删除设备数据库中的对象。使用 SDK 的类型安全性 .where 语法筛选数据，或构建 NSPredicate。

响应变更

活动对象意味着数据始终是最新的。您可以注册通知处理程序来监视变化并执行一些逻辑，例如更新用户界面。或者在 SwiftUI 中，使用 Swift 属性包装器在数据发生变化时更新视图。

连接到 Atlas App Services App

在 App Services App 中配置 Device Sync 。定义数据访问规则。使用开发模式从 Swift 或 Objective-C 数据模型推断模式。

然后，从客户端连接到后端。

验证用户身份

使用我们的身份验证提供者之一对用户进行身份验证。 App Services提供对流行身份验证提供商的访问权限，例如 Apple、Google 或Facebook。使用我们内置的电子邮件/密码提供商在没有第三方的情况下管理用户，或使用自定义JSON web token身份验证与其他身份验证提供程序集成。匿名身份验证提供访问权限，无需登录或保留用户数据。

打开同步数据库

配置并打开同步数据库。订阅查询以确定同步数据库可以读取和写入哪些数据。

读取和写入同步数据

无论您使用的是同步数据库还是非同步数据库，用于读取和写入数据的 API 都是相同的。您在设备中读取和写入的数据会自动与Atlas 集群和其他客户端保持同步。只要网络连接可用，应用程序就会保持离线工作并确定性地同步更改。

Swift SDK 提供属性包装器和便利功能，旨在简化 SwiftUI 的使用。有关演示常见 SwiftUI 模式的视图代码示例，请查看SwiftUI 文档。

SwiftUI属性包装器提供Realm/ SwiftUI集成

struct SearchableDogsView: View {
    @ObservedResults(Dog.self) var dogs
    @State private var searchFilter = ""
    
    var body: some View {
        NavigationView {
            // The list shows the dogs in the realm.
            List {
                ForEach(dogs) { dog in
                    DogRow(dog: dog)
                }
            }
            .searchable(text: $searchFilter,
                        collection: $dogs,
                        keyPath: \.name) {
                ForEach(dogs) { dogsFiltered in
                    Text(dogsFiltered.name).searchCompletion(dogsFiltered.name)
                }
            }
        }
    }
}