Atlas Device SDK for Swift

Atlas Device SDK は非推奨です。詳細については、の廃止ページを参照してください。

Atlas Device SDK for Swift を使用して、Swift と Objective-C で iOS、macOS、watchOS、vOS アプリを開発できます。

ラーニングパス

Swift SDK を使い始める

クイックスタート

Swift SDK の操作方法を示す最小限の説明コード例。デバイスデータベースに書き込み、他のデバイスと同期します。

コード例を参照

動作するサンプルアプリ

Swift SDK を使用する動作する SwiftUI クライアントアプリを切断することで、例えから学びます。

サンプルアプリを調べる

ガイド付きチュートリアル

ガイド付きチュートリアルに従って、サンプルアプリを調整して独自の動作アプリを作成する方法を学びます。

チュートリアルに従う

実現できること

SDK を使用したアプリの開発

SDK のオープンソースデータベース（Realm）をデバイス上のオブジェクトストアとして使用します。 Device Sync を使用して、MongoDB Atlas クラスターや他のクライアントとデータを同期します。

Swift SDK のインストール

Swift パッケージマネージャー、 CocoaPods 、またはカーネルを使用して、プロジェクトに iOS、macOS、vOS、watchOS 用の SDK をインストールします。

プロジェクトファイルに RealmSwiftをインポートして開始します。

オブジェクトスキーマの定義

Swift を使用して、オブジェクトスキーマを慣用的に定義します。

データベースを開きます

SDK のデータベース - Realm - はデバイス上のファイルにオブジェクトを保存します。または、ファイルを作成しないインメモリデータベースを開くこともできます。データベースを構成して開き、データベースファイルのオプションを指定します。

データの読み取りと書込み

デバイスデータベースからオブジェクトを作成、読み取り、更新、削除します。 SDK の型セーフな .where 構文を使用してデータをフィルタリングするか、NSP 述語を構築します。

Reactに対応する

ライブオブジェクトとは、データが常に最新であることを意味します。通知ハンドラーを登録して変更を監視し、UI の更新などのロジックを実行できます。または SwiftUI では、データが変更されたときに Swift プロパティラッパーを使用してビューを更新します。

Atlas App Services アプリへの接続

App Services App で Device Sync を構成します。データアクセスルールを定義します。開発モードを使用して、Swift または Objective-C データモデルからスキーマを推論します。

次に、クライアントからバックエンドに接続します。

ユーザーの認証

認証プロバイダの 1 つを使用して、ユーザーを認証します。 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)
                }
            }
        }
    }
}