Flutter SDK のインストール
Atlas Device SDK for Flutter は、Flutter プロジェクトまたはスタンドアロンの Dart プロジェクトで使用できます。 このガイドでは、両方のタイプのプロジェクトに SDK をインストールする手順を説明します。
前提条件
Atlas Device SDK for Flutter を使い始めるには、開発するアプリのタイプに応じて、以下をインストールする必要があります。
Flutter アプリまたは Dart アプリの場合は、開発環境に Dart と Flutter をインストールします。 Flutter インストールには Dart が含まれています。 その方法については、公式の「 Flutter インストール ガイド」を参照してください。
スタンドアロンの Dart アプリの場合は、Flutter を使用せずに開発環境に Dart をインストールできます。 方法については、 公式の Dart インストール ガイド を参照してください。
Flutter SDK の最新バージョンには、少なくとも次のバージョンが必要です。
Flutter バージョン3.19.0以降。
Dart バージョン3.3.0以降。
サポートされているプラットフォーム
Flutter SDK は次のプラットフォームをサポートしています。
iOS
Android
MacOS
64ビット アーキテクチャで実行中の Windows
64 ビット アーキテクチャで実行されている Linux
重要
サポートされていないプラットフォーム
Flutter SDK は次のプラットフォームをサポートしていません。
Web
ARM 64または32ビット アーキテクチャで実行されている Windows
ARM64 または 32 ビット アーキテクチャで実行されている Linux
SDK のインストール
Atlas Device SDK for Flutter には、Flutter または Dart スタンドアロン アプリのどちらを開発しているかに応じて、インストールに使用できる 2 つのパッケージがあります。
realm：Flutter アプリケーションで使用するための Flutter SDK パッケージ。realm_dart: CLI アプリやサーバー環境で Dart を実行するなどの Dart アプリケーションで使用するスタンドアロンの Dart SDK パッケージ。
スタンドアロンの Dart パッケージは、特に明示された場合を除き、Flutter パッケージと同じ使用量です。
Tip
Atlas Device SDK と Realm
Flutter SDK は、デバイス データの永続化に Realm Core データベースを使用します。 Flutter SDK をインストールすると、パッケージ名に Realm の命名が反映されます。
プロジェクトの作成
Flutter プロジェクトを作成するには、次のコマンドを実行します。
flutter create <app_name> cd <app_name>
詳細については、Flutter の「 使用 開始ガイド 」を参照してください。
Dart プロジェクトを作成するには、次のコマンドを実行します。
dart create <app_name> cd <app_name>
詳細については、 Dart の使用 開始ガイド を参照してください スタンドアロンの Dart コマンドラインおよびサーバー アプリケーション用。
プロジェクトへの SDK の追加
Flutter SDK をプロジェクトに追加するには、次のコマンドを実行します。
flutter pub add realm
これにより、 Realm がダウンロードされます パッケージを作成し、それがプロジェクトに追加されます。
pubspec.yamlファイルには、次の情報が表示されます。
dependencies: realm: <latest_version>
注意
macOS アプリでのネットワーク使用
macOS App Sandbox で Flutter SDK を使用して開発していて、ネットワーク アクセスが必要な場合は、アプリでネットワーク権限を有効にする必要があります。 デフォルトでは、組み込みの macOS セキュリティ設定により、ネットワークリクエストは許可されていません。
macOS アプリでネットワークを使用するには、アプリの macOS ネットワーク権限を変更する必要があります。 その方法については、「 macOS App Sandbox で Realm を使用する 」を参照してください。
プロジェクトに SDK を追加するには、次のコマンドを実行します。
dart pub add realm_dart
これにより、 Realm_dart がダウンロードされます パッケージを作成し、それがプロジェクトに追加されます。
pubspec.yamlファイルには、次の情報が表示されます。
dependencies: realm_dart: <latest_version>
パッケージが追加された後、次のコマンドを実行してインストールします。
dart run realm_dart install
これにより、必要なネイティブ バイナリがダウンロードされ、アプリ ディレクトリにコピーされます。
パッケージのバージョンを更新する
プロジェクト内の SDK のバージョンを変更するには、 パッケージまたはrealm realm_dartパッケージのどちらを使用しているかに応じて、次の手順を実行します。
オブジェクトモデルの再生成
dart run realm generate
dart run realm_dart generate
重要
Flutter SDK v 2.0.0 生成されたファイルへの重大な変更
Flutter SDK バージョン2.0.0 はビルダにアップデートを導入し、ファイルの生成方法に影響を与えます。 v 2.0.0以降では、生成されたすべてのファイルで.g.dartではなく.realm.dartの命名規則が使用されます。
これは既存のアプリにとって重大な変更です。 既存のアプリを以前の SDK バージョンから v 2.0.0以降にアップグレードする方法については、「 Flutter SDK v 2.0.0へのアップグレード 」を参照してください。
トラブルシューティング
アプリケーションで更新された SDK バージョンを使用する際に問題が発生する場合は、SDK によって作成された.realmデータベース ファイルを削除して、アプリケーションを再起動できます。 .realmファイルを削除すると、そのクライアントの データベースに保存されているすべてのデータも削除されることに注意してください。
Apple プライバシーマニフェスト
バージョン2.2.0の新機能。
Appleは、プライバシーマニフェストを提供するために、必要な理由APIを使用するすべてのアプリまたはサードパーティ SDKを要求します。 マニフェストには、アプリのまたは SDK のデータコレクションと使用方法に関する詳細が含まれており、新しいアプリまたはアプリのアップデートを Apple App Store に送信する際に含める必要があります。 これらの要件の詳細については、「 今後のサードパーティ SDK 要件 」を参照してください。 （Apple Developer Webサイト）。
Flutter SDK バージョン2.2.0以降、SDK にはrealmパッケージに含まれるiOSおよびmacOS環境用のプライバシーマニフェストが付属します。 どちらのプライバシーマニフェストにも、Apple に必要な API 公開と、それらの API を使用する理由が含まれています。
これらのプライバシーマニフェストは、SDK パッケージまたは realm-dart Githubリポジトリで直接表示できます。
iOS: https://github.com/realm/realm-dart/blob/main/packages/realm/ios/Resources/PrivacyInfo.xcprivacy
Flutter SDK では次のことは行われません。
App Store のビルドに分析コードを含めます。
Atlas にログインします。
重要
App Services には追加のディスク容量が必要になる場合があります
Flutter SDK プライバシーマニフェストには、App Services API の公開は含まれていません。
アプリがユーザー認証や Device Sync などの Atlas App Services 機能を使用する場合は、これらの API を使用する際にデータコレクションを詳細する追加の公開情報を提供し、プラクティスを使用する必要がある場合があります。 たとえば、アプリが App クライアントを次のように初期化する場合、
詳細については、「 Apple の プライバシーマニフェスト ファイル 」 を参照してください ドキュメント。