Kotlin SDK のインストール
Atlas Device SDK for Kotlin は次のプラットフォームをサポートしています。 各 には独自のインストール方法と要件があります。
前提条件
開始する前に、開発環境が次の前提条件を満たしていることを確認してください。
Android Studio バンドル式2021 。1 。1またはそれ以上
JDK 11 以上
Kotlin Plugin for Android Studio バージョン 1.6.10 以上
サポート対象の CPU アーキテクチャが使用されている Android Virtual Device(AVD)
サポートされているターゲット環境のリストについては、このページの「サポートされているターゲット環境」セクションを参照してください。
さらに、モバイル プロジェクト用の Kotlin マルチプラットフォーム(KMIP)には次のものが必要です。
Kotlin マルチプラットフォーム モバイル(KMM)プラグイン Android Studio バージョン0 。3 。1またはそれ以上
Android Studio の「 Kotlin マルチプラットフォーム アプリ 」テンプレートを使用して作成された Kotlin マルチプラットフォーム(KMIP)アプリ Kotlin マルチプラットフォーム ドキュメントの手順に従います。
KMIP 環境のセットアップに関する詳細については 、モバイル用の公式 Kotlin Kotlin マルチプラットフォームを 参照してください。 ドキュメント。環境設定を確認するには、 Kotlin の ガイドに従って環境を確認します。
Tip
Kotlin プラグイン バージョン
Kotlin マルチプラットフォーム(KMP)のエコシステムは頻繁に変更されます。 SDK のインストールに問題が発生した場合は、 Kotlin Plugin のバージョンを確認してください 。古いプラグインではデバッグが困難なエラーが発生する可能性があるためです。 Plugin のどのバージョンが SDK と互換性があるかを確認するには、「 SDKKotlin の変更ログ 」を参照してください。
インストール
Tip
Atlas Device SDK と Realm
SDKは、デバイス データの永続化に Realm Core データベースを使用します。 Kotlin SDK をインストールすると、パッケージ名には Realm の命名が反映されます。
プロジェクトへの SDK の追加
ライブラリのバージョンを指定してio.realm.kotlin
とapply false
を、プロジェクトレベルの Gradle ビルド ファイルのプラグインのリストに追加します。プラグインは通常<project>/build.gradle
にあります。
plugins { id 'io.realm.kotlin' version '1.16.0' apply false }
以下をアプリレベルの Gradle ビルド ファイルに追加します。通常、 <project>/app/build.gradle
にあります。
プラグインのリストに
io.realm.kotlin
を追加します。以下を依存関係のリストに追加します。
依存関係ブロックに
io.realm.kotlin:library-base
を追加します。アプリケーションで Device Sync を使用する場合は、依存関係ブロックに
io.realm.kotlin:library-sync
を追加します。
SDK でコルーチンを使用するには、依存関係のリストに
org.jetbrains.kotlinx:kotlinx-coroutines-core
を追加します。
plugins { id 'com.android.application' id 'org.jetbrains.kotlin.android' id 'io.realm.kotlin' } android { // ... build configuration settings } dependencies { implementation 'io.realm.kotlin:library-base:1.16.0' // If using Device Sync implementation 'io.realm.kotlin:library-sync:1.16.0' // If using coroutines with the SDK implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.0' }
以下をアプリレベルの Gradle ビルド ファイルに追加します。通常、
<project>/app/build.gradle
にあります。プラグインのリストに
io.realm.kotlin
を追加します。以下を依存関係のリストに追加します。
依存関係ブロックに
io.realm.kotlin:library-base
を追加します。アプリケーションで Device Sync を使用する場合は、依存関係ブロックに
io.realm.kotlin:library-sync
を追加します。
SDK でコルーチンを使用するには、依存関係のリストに
org.jetbrains.kotlinx:kotlinx-coroutines-core
を追加します。
アプリ build.groupleplugins { kotlin("multiplatform") kotlin("native.cocoapods") id("com.android.library") id("io.realm.kotlin") version "1.16.0" } version = "1.0" kotlin { android() iosX64() iosArm64() sourceSets { val commonMain by getting { dependencies { implementation("io.realm.kotlin:library-base:1.16.0") // If using Device Sync implementation("io.realm.kotlin:library-sync:1.16.0") // If using coroutines with the SDK implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.0") } } } } Android モジュール内で SDK の一部を使用する場合は、次のコンパイル時依存関係をモジュールレベルの Gradle ビルド ファイルに追加します(通常は
<project>/module/build.gradle
にあります)。Android モジュール build. Gradledependencies { compileOnly("io.realm.kotlin:library-base:1.16.0") } // If using Device Sync dependencies { compileOnly("io.realm.kotlin:library-sync:1.16.0") }
サポートされているターゲット環境
Kotlin マルチプラットフォーム(KMP)は、幅広いアプリケーション環境をサポートします Kotlin の マルチプラットフォーム Gradle DSL に関する参考資料も参照してください。 ターゲット ドキュメント。
サポートされている環境
Kotlin SDK は次の環境をサポートしています。
android
iosArm64
iosSimulatorArm64
iosX64
jvm
macosArm64
macosX64
サポートされていない環境
Kotlin SDK は次の環境をサポートしていません。
androidNativeArm32
androidNativeArm64
androidNativeX86
androidNativeX64
iosArm32
js
linuxArm32Hfp
linuxArm64
linuxMips32
linuxMipsel32
linuxX64
mingwX64
mingwX86
tvosArm64
tvosSimulatorArm64
tvosX64
wasm32
watchosArm32
watchosArm64
watchosSimulatorArm64
watchosX86
watchosX64