Docs Menu
Docs Home
/ /
Atlas Device SDK

iOS、macOS、vOS、watchOS 用の SDK のインストール

Atlas Device SDK for Swift を使用すると、Swift または Objective-C プログラミング言語のいずれかを使用して、iOS、macOS、vOS、watchOS アプリケーションを構築できます。 このページでは、プロジェクトに SDK をインストールして開始する方法について詳しく説明します。

開始する前に、開発環境が次の前提条件を満たしていることを確認してください。

  • プロジェクトでは、Xcode バージョン と、このページの OS サポートセクションにリストされている最小の OS バージョン を使用しています。

  • プロジェクトで反映が有効になっている。 Swift SDK はリフレクションを使用してモデルのプロパティを決定します。 プロジェクトでは SWIFT_REFLECTION_METADATA_LEVEL = noneを設定しないでください。そうでない場合、SDK はモデル内のプロパティを表示できません。 プロジェクトでこの設定のレベルが特に設定されていない場合は、反映はデフォルトで有効になります。

Swift SDK をプロジェクトに追加するには、 SwiftPMCocoaPods 、またはCarthageを使用します。

Tip

Atlas Device SDK と Realm

SDKは、デバイス データの永続化に Realm Core データベースを使用します。 Swift SDK をインストールすると、パッケージ名には Realm の命名が反映されます。

1

Xcode で、 File > Add Packages...を選択します。

2

以下をコピーして、検索/入力ボックスに貼り付けます。

https://github.com/realm/realm-swift.git
3

パッケージのオプションでは、 realm-swiftDependency RuleUp to Next Major Version に設定し、現在のRealm Swift SDKバージョン を入力することをお勧めします。次に、Add Package をクリックします。

4

バージョン10.49.3での変更: 両方を追加するのではなく、パッケージを 1 つだけ追加します。

RealmSwiftまたはRealmのいずれかを選択し、 Add Packageをクリックします。

  • Swift または Swift と Objective-C API を使用する場合は、 RealmSwiftを追加します。

  • Objective-C APIのみを使用する場合は、 Realmを追加します。

5

SDK によって提供されるプライバシー マテリアライズドを使用するには、 RealmSwiftを動的フレームワークとしてビルドします。 RealmSwiftを静的フレームワークとして構築する場合は、独自のプライバシーマニフェストを指定する必要があります。

RealmSwiftを動的フレームワークとして構築するには:

  1. プロジェクト Targetsで、ビルド ターゲットを選択します。

  2. [General] タブに移動します。

  3. Frameworks and Libraries要素を展開します。

  4. RealmSwiftフレームワークの場合は、 Embedオプションを [DoNot埋め込み] から [埋め込みと署名] に変更します。

Xcode はRealmSwiftを動的に構築し、SDK が提供するプライバシーマニフェストを提供できるようになりました。

CocoaPods を使用してインストールしている場合は、 CocoaPods 1.10.1 が必要です。以降に更新します。

1

コマンドラインでpod repo updateを実行して、 CocoaPods が利用可能な最新の Realm バージョンにアクセスできるようにします。

2

プロジェクト用の ポッドファイルがまだない場合は、プロジェクトのルート ディレクトリでpod initを実行してプロジェクト用の ポッドファイルを作成します。 ポッドファイルを使用すると、 CocoaPods へのプロジェクトの依存関係を指定できます。

3

pod 'Realm', '~>10'をメインターゲットとテストターゲットに追加します。

まだ存在しない場合は、 use_frameworks!行も追加します。

完了すると、Pedfile は次のようになります。

# Uncomment the next line to define a global platform for your project
# platform :ios, '11.0'
target 'MyDeviceSDKProject' do
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
# Pods for MyDeviceSDKProject
pod 'Realm', '~>10'
target 'MyRealmProjectTests' do
inherit! :search_paths
# Pods for testing
pod 'Realm', '~>10'
end
end

use_frameworks!行がまだ存在しない場合は追加します。

pod 'RealmSwift', '~>10'をメインターゲットとテストターゲットに追加します。

完了すると、Pedfile は次のようになります。

platform :ios, '12.0'
target 'MyDeviceSDKProject' do
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
# Pods for MyDeviceSDKProject
pod 'RealmSwift', '~>10'
end
4

コマンドラインから、 pod installを実行して依存関係を取得します。

5

CocoaPods は.xcworkspaceファイルを生成します。 このファイルには、すべての依存関係が構成されています。 今後は、 .xcodeprojファイルではなくこのファイルを開き、プロジェクトを操作します。

カーネル を使用してインストールしている場合は、0 カーターム.33 以降が必要です。

1

カードファイルに行github "realm/realm-swift"を追加して、SDK を依存関係として追加します。

プロジェクト ディレクトリで次のコマンドを実行すると、カードファイルを作成したり、既存のファイルに追加したりできます。

echo 'github "realm/realm-swift"' >> Cartfile
2

コマンドラインから、 carthage update --use-xcframeworksを実行して依存関係を取得します。

3

カーネルはビルドされた依存関係をCarthage/Buildディレクトリに配置します。

Xcode でプロジェクトのxcodeprojファイルを開きます。 [ Project Navigator ] パネルにGoし、アプリケーション名をクリックしてプロジェクト設定エディターを開きます。 Generalタブを選択します。

Finder で、 Carthage/Build/ディレクトリを開きます。 RealmSwift.xcframeworkRealm.xcframeworkそのディレクトリにある ファイルとFrameworks, Libraries, and Embedded Content ファイルを、プロジェクトのGeneral 設定の セクションにドラッグします。

xc Framework ファイルを Xcode プロジェクトにドラッグします。
クリックして拡大します
1

Swift SDKの最新リリースをダウンロードし、zip を抽出します。

2

Realm.xcframeworkRealmSwift.xcframework (使用している場合)を Xcode プロジェクトのファイル ナビゲータにドラッグします。 Copy items if neededチェックボックスをオンにして、 Finishを押します。

Tip

Swift プロジェクト内で Objective-C API を使用する場合は、Realm Swift と Realm Objective-C の両方をプロジェクトに含めることをお勧めします。 Swift ファイル内で、Swift API とすべての必要なラッパーにアクセスできます。 混合 Swift プロジェクトと Objective-C プロジェクトで RealmSwift API を使用できるのは、RealmSwift 型の大部分が Objective-C カウンター から直接エイリアスであるためです。

Tip

Atlas Device SDK と Realm

SDKは、デバイス データの永続化に Realm Core データベースを使用します。 Swift SDK をインポートすると、パッケージ名には Realm の命名が反映されます。

SDK を使用するには、ソース ファイルの先頭に次の行を追加します。

#include <Realm/Realm.h>
import RealmSwift

SDK は、アプリのダウンロード サイズに約 5 MBから 8 MB を追加するだけです。 配布されるリリースは、iOS、watchOS、vOS シミュレーター、一部のデバッグ シンボル、ビットコードのサポートが含まれているため、大幅に大きくなります。これらはすべて、アプリがダウンロードされると App Store によって自動的に削除されます。

これらの方法のいずれかを使用して SDK をインストールした後にビルドの問題が発生した場合は、それらの問題の解決に関する情報については、 トラブルシューティング ガイドラインを参照してください。

重要

vOS で SDK を使用する場合は、特別な考慮事項があります。 詳細については、「 vOS 用のビルド 」を参照してください。

バージョン10.50.0での変更: 必要な Xcode の最小バージョンは15.1です

サポートされている OS
Realm
Atlas App Services

iOS 12.0+

X

X

macOS 10.14 +

X

X

tvOS 12.0+

X

X

watchOS 4.0+

X

viewOS 1.0+

X

X

バージョン10.50.0での変更: Xcode 14のサポートを廃止しました。

Swift SDK バージョン10.50.0 Xcode 14のサポートを廃止します。 v 10.49.3以前の場合は、これらの Xcode 14要件が適用されます。

  • Xcode バージョン 14.1 以上

  • Xcode 14を使用する場合、iOS 11.0以上、macOS 10.13以上、dbOS 11.0以上、または watchOS 4.0以上がターゲットです。

Swift SDK は、Swift の同時実行関連言語機能をサポートしています。 Swift SDK の同時実行機能の使用に関するベストプラクティスについては、以下のドキュメントを参照してください。

Realm Swift SDK バージョン 10.15.0 および 10.16.0 以降では、Realm API の多くが Swift async/await 構文をサポートしています。 プロジェクトは、次の要件を満たしている必要があります。

Swift SDK バージョン
Swift バージョン要件
サポートされている OS

10.25.0

Swift 5.6

iOS 13.x

10.15.0 または 10.16.0

Swift 5.5

iOS 15.x

アプリがasync/awaitコンテキストで Realm にアクセスする場合は、スレッド関連のクラッシュを回避するためにコードを@MainActorでマークします。

Swift SDK での async/await サポートの詳細については、「 Swift 同時実行性: Async/Await API 」を参照してください。

The Swift SDK supports actor-isolated realm instances. 詳細については、 「 アクターで Realm を使用する - Swift SDK 」を参照してください。

バージョン10.49.3での変更: プライバシーマニフェストを含めるための動的フレームワークとして RealmSwift をビルドします。

Apple は、SDK のデータコレクションと使用プラクティスの詳細を含むプライバシーマニフェストを提供するために、RealmSwift を使用するアプリを要求します。新しいアプリまたはアプリのアップデートをApp Storeに送信するときに、バンドルされたマニフェストファイルを含める必要があります。Apple の要件の詳細については、 Apple 開発者ウェブサイトで 今後のサードパーティ SDK 要件 を参照してください。

Swift SDK バージョン 10.46.0 以降、SDK はRealmRealmSwiftのプライバシーマニフェストとともに出荷されます。 各パッケージには、Apple が要求する API 公開とそれらの API を使用する理由が記載された、独自のプライバシーマニフェストが含まれています。

プライバシーマニフェストは、各パッケージまたは realm-swift Githubリポジトリで表示できます。

これらのマニフェストをRealmSwiftを使用するビルド ターゲットに含めるには、 RealmSwiftを動的フレームワークとしてビルドする必要があります。 詳細については、「 Swift パッケージ マネージャーのインストール 」手順のステップ(任意)「 動的フレームワークとして RealmSwift を構築する 」を参照してください。

Swift SDK は、App Store のビルドには分析コードを含めません。 SDK は、自分自身の代わりに Atlas にログインしません。

App Services 機能を使用するアプリを作成する場合(App Servicesクライアントを初期化して次のようにする場合など)、

これらの API を使用する場合は、データコレクションと使用プラクティスを詳述するアプリのプライバシーマニフェストに追加の情報表示を追加する必要がある場合があります。

詳細については、 Apple のプライバシーマニフェスト ファイルのドキュメントを参照してください。

次へ

Atlas Device SDK Docsへようこそ

項目一覧