推奨される Kotlin Multiplatform プロジェクト構造
基本および高度なプロジェクト構造の概念の概要を通じて、ソースセットと依存関係の管理について理解できたかと思います。 では、ソースセットを整理し、依存関係に依存するモジュール自体はどう構成すべきでしょうか?
この記事では、特に KMP プロジェクトについて説明します。 モジュール化の意思決定に関する一般的な理解については、Android のモジュール化の概要を参照してください。
最適なモジュール構造
最適なモジュール構造は、目的や必要なターゲットによって異なります。 デフォルトでプロジェクトがどのように構成されているかを確認するには、KMP IDE プラグインのウィザードでさまざまな構成やターゲットのセットを指定した際の出力を分析してみてください。
一般的なアプローチは次のようにまとめられます:
- アプリのエントリポイントは個別のモジュールに配置し、それぞれのモジュールが必要な共有コードモジュールに依存するようにします。
- 共有コードは一般にビジネスロジックと UI に分割され、不要な依存関係を避ける戦略をとります:
- KMP プロジェクトによって作成されるすべてのアプリで共有 UI コードと共有ビジネスロジックの両方を使用する場合、すべての共有コードに対して単一の
sharedモジュールを用意するだけで十分な場合があります。 - いずれかのアプリの UI がネイティブコードで記述されている場合(たとえば、iOS の UI を純粋な Swift で実装した場合)、不要な場所で Compose Multiplatform への依存が発生するのを避けるため、UI コードをビジネスロジックから分離するのが合理的です。 そのため、
sharedLogicモジュールとsharedUIモジュールを用意し、必要に応じてエントリポイントモジュールへの依存関係として追加できます。
- KMP プロジェクトによって作成されるすべてのアプリで共有 UI コードと共有ビジネスロジックの両方を使用する場合、すべての共有コードに対して単一の
- プロジェクトにクライアントアプリとロジックを共有するサーバーコードが含まれている場合、推奨される構成は次のとおりです:
- 上記のように構成されたエントリポイントモジュールとクライアント共通コードモジュールを含む
appフォルダ。 - サーバー固有のコードを含む
serverモジュール。 - モデルやバリデーションなど、サーバーとクライアント間で共有されるコード用の
coreモジュール。
- 上記のように構成されたエントリポイントモジュールとクライアント共通コードモジュールを含む
プロジェクトで、アプリのエントリポイントと共有コードが単一のモジュールに含まれる古い構造を使用している場合は、以下のガイドに従ってエントリポイントを個別のモジュールに抽出できます。
Android Gradle Plugin 9 以降を使用する場合は、Android アプリのエントリポイントを共通コードから分離することが必須となります。 詳細については、AGP 9 移行に関する記事を参照してください。
アプリのエントリポイント用に個別のモジュールを作成する
推奨構造への移行を説明するために使用するサンプルプロジェクトは、サンプルリポジトリの old-project-structure ブランチにある古い Compose Multiplatform サンプルです。
このサンプルは、すべての共有コードと KMP エントリポイントを含む単一の Gradle モジュール(composeApp)と、iOS プロジェクトのコードと設定を含む iosApp フォルダで構成されています。
エントリポイントを独自のモジュールに抽出するには、モジュールを作成し、コードを移動し、新しいモジュールと共通コードモジュールの両方に対して設定を適宜調整する必要があります。
Android アプリのエントリポイント用モジュール
Android アプリモジュールの作成と設定
Android アプリモジュール(androidApp)を作成するには:
プロジェクトのルートに
androidAppディレクトリを作成します。そのディレクトリ内に、空の
build.gradle.ktsファイルとsrcディレクトリを作成します。settings.gradle.ktsファイルの末尾に次の行を追加して、プロジェクト設定に新しいモジュールを追加します:kotlininclude(":androidApp")メインメニューで Build | Sync Project with Gradle Files を選択するか、エディタ内の Gradle リフレッシュボタンをクリックします。
Android アプリ用ビルドスクリプトの設定
新しいモジュールの Gradle ビルドスクリプトを設定します:
gradle/libs.versions.tomlファイルで、バージョンカタログに Kotlin Android Gradle プラグインを追加します:toml[plugins] kotlinAndroid = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }androidApp/build.gradle.ktsファイルで、Android アプリモジュールに必要なプラグインを指定します:kotlinplugins { alias(libs.plugins.kotlinAndroid) alias(libs.plugins.androidApplication) alias(libs.plugins.composeMultiplatform) alias(libs.plugins.composeCompiler) }これらすべてのプラグインがルートの
build.gradle.ktsファイルに記載されていることを確認します:kotlinplugins { alias(libs.plugins.kotlinAndroid) apply false alias(libs.plugins.androidApplication) apply false alias(libs.plugins.composeMultiplatform) apply false alias(libs.plugins.composeCompiler) apply false // ... }必要な依存関係を追加するには、
composeAppのビルドスクリプトのandroidMain.dependencies {}ブロックから既存の依存関係をコピーし、composeAppモジュール自体への依存関係を追加します。 この例では、結果は次のようになります:kotlinkotlin { dependencies { implementation(projects.composeApp) implementation(libs.androidx.activity.compose) implementation(libs.compose.uiToolingPreview) } }Android 固有の設定が含まれる
composeApp/build.gradle.ktsファイルのandroid {}ブロック全体を、androidApp/build.gradle.ktsファイルにコピーします。composeApp/build.gradle.ktsファイルのandroidTarget {}ブロックからコンパイラオプションを、androidApp/build.gradle.ktsファイルのtarget {}ブロックにコピーします:kotlinkotlin { target { compilerOptions { jvmTarget.set(JvmTarget.JVM_11) } } }composeAppビルドスクリプトに設定されているその他のプラグインやプロパティがある場合は、それらもandroidAppビルドスクリプトに移行してください。composeAppモジュールは実質的に Android ライブラリとなるため、Android アプリケーションから Android ライブラリへと設定を変更します。composeApp/build.gradle.ktsで以下を行います:Gradle プラグインの参照を変更します:
変更前kotlinalias(libs.plugins.androidApplication)変更後kotlinalias(libs.plugins.androidLibrary)android.defaultConfig {}ブロックからアプリケーションプロパティの行を削除します:変更前kotlindefaultConfig { applicationId = "com.jetbrains.demo" minSdk = libs.versions.android.minSdk.get().toInt() targetSdk = libs.versions.android.targetSdk.get().toInt() versionCode = 1 versionName = "1.0" }変更後kotlindefaultConfig { minSdk = libs.versions.android.minSdk.get().toInt() }
メインメニューで Build | Sync Project with Gradle Files を選択するか、エディタ内の Gradle リフレッシュボタンをクリックします。
コードの移動と Android アプリの実行
composeApp/src/androidMainディレクトリをandroidApp/src/ディレクトリに移動します。ただし、クロスプラットフォームのままにしておくべきコードに注意してください:- Android アプリを適切にビルドするには、サンプルの
MainActivity.ktなどのエントリポイントコードがandroidAppモジュール内に存在する必要があります。 - すべての期待される宣言と実際の宣言 (expected and actual declarations)は、すべてのプラットフォームで利用できるようにするために、共通モジュール(この例では
composeApp)のソースセットに残しておく必要があります。androidAppからcomposeAppへの依存関係を設定しているため、宣言はエントリポイントコードでも利用できます。
- Android アプリを適切にビルドするには、サンプルの
androidApp/src/androidMainディレクトリの名前をmainに変更します。すべてが正しく設定されていれば、
androidApp/src/main/.../MainActivity.ktファイル内のインポートが機能し、コードがコンパイルされます。IntelliJ IDEA または Android Studio を使用している場合、IDE は新しいモジュールを認識し、新しい実行構成(androidApp)を自動的に作成します。 作成されない場合は、composeApp の Android 実行構成を手動で変更します:
- 実行構成のドロップダウンで Edit Configurations を選択します。
- Android カテゴリから composeApp 構成を見つけます。
- General | Module フィールドで、
demo.composeAppをdemo.androidAppに変更します。
新しい実行構成を開始して、アプリが期待どおりに動作することを確認します。
すべてが正しく動作したら、
composeApp/build.gradle.ktsファイルでkotlin.sourceSets.androidMain.dependencies {}ブロックを削除します。
これで、Android のエントリポイントを個別のモジュールに抽出できました。 次に、新しい Android-KMP ライブラリプラグインを使用するように共通コードモジュールを更新します。
デスクトップ JVM アプリ
デスクトップアプリモジュールの作成と設定
デスクトップアプリモジュール(desktopApp)を作成するには:
プロジェクトのルートに
desktopAppディレクトリを作成します。そのディレクトリ内に、空の
build.gradle.ktsファイルとsrcディレクトリを作成します。settings.gradle.ktsファイルに次の行を追加して、プロジェクト設定に新しいモジュールを追加します:kotlininclude(":desktopApp")
デスクトップアプリ用ビルドスクリプトの設定
デスクトップアプリのビルドスクリプトを機能させるには:
gradle/libs.versions.tomlファイルで、バージョンカタログに Kotlin JVM Gradle プラグインを追加します:toml[plugins] kotlinJvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }desktopApp/build.gradle.ktsファイルで、共有 UI モジュールに必要なプラグインを指定します:kotlinplugins { alias(libs.plugins.kotlinJvm) alias(libs.plugins.composeMultiplatform) alias(libs.plugins.composeCompiler) }これらすべてのプラグインがルートの
build.gradle.ktsファイルに記載されていることを確認します:kotlinplugins { alias(libs.plugins.kotlinJvm) apply false alias(libs.plugins.composeMultiplatform) apply false alias(libs.plugins.composeCompiler) apply false // ... }他のモジュールへの必要な依存関係を追加するために、
composeAppビルドスクリプトのcommonMain.dependencies {}およびjvmMain.dependencies {}ブロックから既存の依存関係をコピーします。この例では、最終結果は次のようになります:kotlinkotlin { dependencies { implementation(projects.sharedLogic) implementation(projects.sharedUI) implementation(compose.desktop.currentOs) implementation(libs.kotlinx.coroutinesSwing) } }デスクトップ固有の設定が含まれる
composeApp/build.gradle.ktsファイルのcompose.desktop {}ブロックを、desktopApp/build.gradle.ktsファイルにコピーします:kotlincompose.desktop { application { mainClass = "compose.project.demo.MainKt" nativeDistributions { targetFormats(TargetFormat.Dmg, TargetFormat.Msi, TargetFormat.Deb) packageName = "compose.project.demo" packageVersion = "1.0.0" } } }メインメニューで Build | Sync Project with Gradle Files を選択するか、エディタ内の Gradle リフレッシュボタンをクリックします。
コードの移動とデスクトップアプリの実行
設定が完了したら、デスクトップアプリのコードを新しいディレクトリに移動します:
desktopApp/srcディレクトリ内に、新しいmainディレクトリを作成します。composeApp/src/jvmMain/kotlinディレクトリをdesktopApp/src/main/ディレクトリに移動します: パッケージ座標がcompose.desktop {}の設定と一致していることが重要です。- すべてが正しく設定されていれば、
desktopApp/src/main/.../main.ktファイル内のインポートが機能し、コードがコンパイルされます。 - デスクトップアプリを実行するには、composeApp [jvm] 実行構成を変更します:
- 実行構成のドロップダウンで Edit Configurations を選択します。
- Gradle カテゴリから composeApp [jvm] 構成を見つけます。
- Gradle project フィールドで、
ComposeDemo:composeAppをComposeDemo:desktopAppに変更します。
- 更新した構成を開始して、アプリが期待どおりに動作することを確認します。
- すべてが正しく動作したら:
composeApp/src/jvmMainディレクトリを削除します。composeApp/build.gradle.ktsファイルから、デスクトップ関連のコードを削除します:compose.desktop {}ブロック- Kotlin
sourceSets {}ブロック内のjvmMain.dependencies {}ブロック kotlin {}ブロック内のjvm()ターゲット宣言
Web アプリ
Web アプリモジュールの作成と設定
Web アプリモジュール(webApp)を作成するには:
プロジェクトのルートに
webAppディレクトリを作成します。そのディレクトリ内に、空の
build.gradle.ktsファイルとsrcディレクトリを作成します。settings.gradle.ktsファイルの末尾に次の行を追加して、プロジェクト設定に新しいモジュールを追加します:kotlininclude(":webApp")
Web アプリ用ビルドスクリプトの設定
Web アプリのビルドスクリプトを機能させるには:
webApp/build.gradle.ktsファイルで、共有 UI モジュールに必要なプラグインを指定します:```kotlin plugins { alias(libs.plugins.kotlinMultiplatform) alias(libs.plugins.composeMultiplatform) alias(libs.plugins.composeCompiler) } ```これらすべてのプラグインがルートの
build.gradle.ktsファイルに記載されていることを確認します:kotlinplugins { alias(libs.plugins.kotlinMultiplatform) apply false alias(libs.plugins.composeMultiplatform) apply false alias(libs.plugins.composeCompiler) apply false // ... }composeApp/build.gradle.ktsファイルからwebApp/build.gradle.ktsファイルのkotlin {}ブロックへ、JavaScript および Wasm ターゲット宣言をコピーします:kotlinkotlin { js { browser() binaries.executable() } @OptIn(ExperimentalWasmDsl::class) wasmJs { browser() binaries.executable() } }他のモジュールへの必要な依存関係を追加します:
kotlinkotlin { sourceSets { commonMain.dependencies { implementation(projects.sharedLogic) // 必要なエントリポイント API を提供 implementation(compose.ui) } } }メインメニューで Build | Sync Project with Gradle Files を選択するか、エディタ内の Gradle リフレッシュボタンをクリックします。
コードの移動と Web アプリの実行
設定が完了したら、Web アプリのコードを新しいディレクトリに移動します:
composeApp/src/webMainディレクトリ全体をwebApp/srcディレクトリに移動します。 すべてが正しく設定されていれば、webApp/src/webMain/.../main.ktファイル内のインポートが機能し、コードがコンパイルされます。webApp/src/webMain/resources/index.htmlファイルでスクリプト名を更新します:composeApp.jsからwebApp.jsに変更します。- Web アプリを実行するには、composeApp [wasmJs] 実行構成を変更します:
- 実行構成のドロップダウンで Edit Configurations を選択します。
- Gradle カテゴリから composeApp [wasmJs] 構成を見つけます。
- Gradle project フィールドで、
ComposeDemo:composeAppをComposeDemo:webAppに変更します。
- JavaScript バージョンも実行できるように、composeApp [js] に対しても同様の手順を繰り返します。
- 実行構成を開始して、アプリが期待どおりに動作することを確認します。
- すべてが正しく動作したら:
composeApp/src/webMainディレクトリを削除します。composeApp/build.gradle.ktsファイルから、Web 関連のコードを削除します:- Kotlin
sourceSets {}ブロック内のwebMain.dependencies {}ブロック kotlin {}ブロック内のjs {}およびwasmJs {}ターゲット宣言
- Kotlin
共有モジュールの設定
サンプルのアプリでは UI とビジネスロジックの両方のコードが共有されているため、すべての共通コードを保持するのに必要な共有モジュールは 1 つだけです。単に composeApp を共通コードモジュールとして再利用できます。
Gradle 設定で調整する必要があるエントリポイントモジュールとの接続に関係のない唯一の変更点は、新しい Android Library Gradle プラグインです。 この新しいプラグインはマルチプラットフォームプロジェクト専用に構築されており、AGP 9 以降を使用するために必須です。
必要な変更は以下のとおりです:
gradle/libs.versions.tomlで、バージョンカタログに Android-KMP ライブラリプラグインを追加します:toml[plugins] androidMultiplatformLibrary = { id = "com.android.kotlin.multiplatform.library", version.ref = "agp" }composeApp/build.gradle.ktsファイルで、共有 UI モジュールに必要なプラグインを追加します:kotlinplugins { alias(libs.plugins.kotlinMultiplatform) alias(libs.plugins.androidMultiplatformLibrary) alias(libs.plugins.composeMultiplatform) alias(libs.plugins.composeCompiler) }プラグイン適用時の競合を避けるため、ルートの
build.gradle.ktsファイルに次の行を追加します:kotlinalias(libs.plugins.androidMultiplatformLibrary) apply falsecomposeApp/build.gradle.ktsファイルで、kotlin.androidTarget {}ブロックの代わりにkotlin.androidLibrary {}ブロックを追加します:kotlinandroidLibrary { namespace = "compose.project.demo.composedemo" compileSdk = libs.versions.android.compileSdk.get().toInt() compilerOptions { jvmTarget = JvmTarget.JVM_11 } androidResources { enable = true } }composeApp/build.gradle.ktsファイルからルートのandroid {}ブロックを削除します。すべてのコードがアプリモジュールに移動されたため、
androidMainの依存関係を削除します:kotlin.sourceSets.androidMain.dependencies {}ブロックを削除します。Android アプリが期待どおりに動作することを確認します。
(オプション) 共有ロジックと共有 UI の分離
プロジェクト内の一部のターゲットでネイティブ UI が実装されている場合、共通コードを sharedLogic モジュールと sharedUI モジュールに分離することをお勧めします。これにより、ネイティブ UI を備えたアプリモジュールが共有コードを使用するために Compose Multiplatform に依存する必要がなくなります。
以下は、同じサンプルアプリに基づいたそのアプローチの例です。
共有ロジックモジュールの作成
モジュールを実際に作成する前に、何がビジネスロジックであり、どのコードが UI とプラットフォームの両方に依存しないかを判断する必要があります。 この例で唯一該当するのは、場所とタイムゾーンのペアに対して正確な時刻を返す currentTimeAt() 関数です。 対照的に、Country データクラスは Compose Multiplatform の DrawableResource に依存しているため、UI コードから分離できません。
プロジェクトにすでに shared モジュールが存在する場合(たとえば、UI コードを一部しか共有していない場合など)、sharedLogic の代わりにそのモジュールを使用できます。 共有ロジックと UI をより明確に区別するために、名前を変更してもよいでしょう。
該当するコードを sharedLogic モジュールに切り離します:
プロジェクトのルートに
sharedLogicディレクトリを作成します。そのディレクトリ内に、空の
build.gradle.ktsファイルとsrcディレクトリを作成します。settings.gradle.ktsの末尾に次の行を追加して、新しいモジュールを追加します:kotlininclude(":sharedLogic")新しいモジュールの Gradle ビルドスクリプトを設定します。
gradle/libs.versions.tomlファイルで、バージョンカタログに Android-KMP ライブラリプラグインを追加します:toml[plugins] androidMultiplatformLibrary = { id = "com.android.kotlin.multiplatform.library", version.ref = "agp" }sharedLogic/build.gradle.ktsファイルで、共有ロジックモジュールに必要なプラグインを指定します:kotlinplugins { alias(libs.plugins.kotlinMultiplatform) alias(libs.plugins.androidMultiplatformLibrary) }これらのプラグインがルートの
build.gradle.ktsファイルに記載されていることを確認します:kotlinplugins { alias(libs.plugins.androidMultiplatformLibrary) apply false alias(libs.plugins.kotlinMultiplatform) apply false // ... }sharedLogic/build.gradle.ktsファイルで、この例で共通モジュールがサポートすべきターゲットを指定します:kotlinkotlin { // sharedLogic はフレームワークとしてエクスポートされず、 // 'sharedUI' のみがエクスポートされるため、iOS フレームワークの設定は不要です。 iosArm64() iosSimulatorArm64() jvm() js { browser() } @OptIn(ExperimentalWasmDsl::class) wasmJs { browser() } }Android の場合、
androidTarget {}ブロックの代わりにkotlin {}ブロックへandroidLibrary {}設定を追加します:kotlinkotlin { // ... androidLibrary { namespace = "com.jetbrains.greeting.demo.sharedLogic" compileSdk = libs.versions.android.compileSdk.get().toInt() minSdk = libs.versions.android.minSdk.get().toInt() compilerOptions { jvmTarget = JvmTarget.JVM_11 } } }composeAppで宣言されているのと同じ方法で、共通および JavaScript ソースセットに必要な日時の依存関係を追加します:kotlinkotlin { sourceSets { commonMain.dependencies { implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.8.0") } webMain.dependencies { implementation(npm("@js-joda/timezone", "^2.25.2")) } } }メインメニューで Build | Sync Project with Gradle Files を選択するか、エディタ内の Gradle リフレッシュボタンをクリックします。
最初に特定したビジネスロジックコードを移動します:
sharedLogic/src内にcommonMain/kotlinディレクトリを作成します。commonMain/kotlin内にCurrentTime.ktファイルを作成します。- 元の
App.ktからcurrentTimeAt関数をCurrentTime.ktに移動します。
新しい場所にあるこの関数を
App()コンポーザブルから利用できるようにします。 そのためには、composeApp/build.gradle.ktsファイルでcomposeAppとsharedLogic間の依存関係を宣言します:kotlincommonMain.dependencies { implementation(projects.sharedLogic) }再度 Build | Sync Project with Gradle Files を実行して変更を適用します。
composeApp/commonMain/.../App.ktファイルでcurrentTimeAt()関数をインポートし、コードを修正します。アプリケーションを実行して、新しいモジュールが適切に機能することを確認します。
これで、共有ロジックを個別のモジュールに分離し、クロスプラットフォームで使用することに成功しました。 次のステップは、共有 UI モジュールの作成です。
共有 UI モジュールの作成
共通の UI 要素を実装する共有コードを sharedUI モジュールに抽出します:
プロジェクトのルートに
sharedUIディレクトリを作成します。そのディレクトリ内に、空の
build.gradle.ktsファイルとsrcディレクトリを作成します。settings.gradle.ktsの末尾に次の行を追加して、新しいモジュールを追加します:kotlininclude(":sharedUI")新しいモジュールの Gradle ビルドスクリプトを設定します:
sharedLogicモジュールでまだ行っていない場合は、gradle/libs.versions.tomlでバージョンカタログに Android-KMP ライブラリプラグインを追加します:toml[plugins] androidMultiplatformLibrary = { id = "com.android.kotlin.multiplatform.library", version.ref = "agp" }sharedUI/build.gradle.ktsファイルで、共有 UI モジュールに必要なプラグインを指定します:kotlinplugins { alias(libs.plugins.kotlinMultiplatform) alias(libs.plugins.androidMultiplatformLibrary) alias(libs.plugins.composeMultiplatform) alias(libs.plugins.composeCompiler) }これらすべてのプラグインがルートの
build.gradle.ktsファイルに記載されていることを確認します:kotlinplugins { alias(libs.plugins.androidMultiplatformLibrary) apply false alias(libs.plugins.composeMultiplatform) apply false alias(libs.plugins.composeCompiler) apply false alias(libs.plugins.kotlinMultiplatform) apply false // ... }kotlin {}ブロックで、この例で共有 UI モジュールがサポートすべきターゲットを指定します:kotlinkotlin { listOf( iosArm64(), iosSimulatorArm64() ).forEach { iosTarget -> iosTarget.binaries.framework { // これは Swift コードでインポートする // iOS フレームワークの名前です。 baseName = "sharedUI" isStatic = true } } jvm() js { browser() binaries.executable() } @OptIn(ExperimentalWasmDsl::class) wasmJs { browser() binaries.executable() } }Android の場合、
androidTarget {}ブロックの代わりにkotlin {}ブロックへandroidLibrary {}設定を追加します:kotlinkotlin { // ... androidLibrary { namespace = "com.jetbrains.greeting.demo.sharedUI" compileSdk = libs.versions.android.compileSdk.get().toInt() minSdk = libs.versions.android.minSdk.get().toInt() compilerOptions { jvmTarget = JvmTarget.JVM_11 } // Compose Multiplatform リソースを Android アプリで使用できるようにする androidResources { enable = true } } }composeAppで宣言されているのと同じ方法で、共有 UI に必要な依存関係を追加します:kotlinkotlin { sourceSets { commonMain.dependencies { implementation(projects.sharedLogic) implementation(compose.runtime) implementation(compose.foundation) implementation(compose.material3) implementation(compose.ui) implementation(compose.components.resources) implementation(compose.components.uiToolingPreview) implementation(libs.androidx.lifecycle.viewmodelCompose) implementation(libs.androidx.lifecycle.runtimeCompose) implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.8.0") } } }メインメニューで Build | Sync Project with Gradle Files を選択するか、エディタ内の Gradle リフレッシュボタンをクリックします。
sharedUI/src内に新しいcommonMain/kotlinディレクトリを作成します。リソースファイルを
sharedUIモジュールに移動します:composeApp/commonMain/composeResourcesディレクトリ全体をsharedUI/commonMain/composeResourcesに配置し直します。sharedUI/src/commonMain/kotlinディレクトリ内に、新しいApp.ktファイルを作成します。元の
composeApp/src/commonMain/.../App.ktの内容全体を新しいApp.ktファイルにコピーします。古い
App.ktファイル内のすべてのコードを一時的にコメントアウトします。 これにより、古いコードを完全に削除する前に、共有 UI モジュールが動作しているかどうかをテストできます。新しい
App.ktファイルは期待どおりに動作するはずですが、リソースのインポートのみ異なるパッケージに配置されているため調整が必要です。 正しいパスでResオブジェクトとすべてのドローアブルリソースを再インポートします。例:変更前kotlinimport demo.composeapp.generated.resources.mx変更後kotlinimport demo.sharedui.generated.resources.mx新しい
App()コンポーザブルを、これを利用するアプリモジュールのエントリポイントから利用できるようにするために、対応するbuild.gradle.ktsファイルに依存関係を追加します:kotlinkotlin { sourceSets { commonMain.dependencies { implementation(projects.sharedUI) // ... } } }アプリを実行して、新しいモジュールがアプリのエントリポイントに共有 UI コードを適切に提供していることを確認します。
composeApp/src/commonMain/.../App.ktファイルを削除します。
これで、クロスプラットフォーム UI コードを専用モジュールに正常に移動できました。
iOS 連携の更新
iOS アプリのエントリポイントは個別の Gradle モジュールとしてビルドされないため、ソースコードは任意のモジュールに組み込むことができます。 この例では、shared 内に残しておくことができます:
composeApp/src/iosMainディレクトリをshared/srcディレクトリに移動します。sharedモジュールによって生成されたフレームワークを使用するように Xcode プロジェクトを設定します:File | Open Project in Xcode メニュー項目を選択します。
Project navigator ツールウィンドウで iosApp プロジェクトをクリックし、Build Phases タブを選択します。
Compile Kotlin Framework フェーズを見つけます。
./gradlewで始まる行を見つけ、composeAppをsharedUiに置き換えます:text./gradlew :shared:embedAndSignAppleFrameworkForXcodeContentView.swiftファイル内のインポートは、モジュールの実際の名前ではなく、iOS ターゲットの Gradle 設定におけるbaseNameパラメータと一致しているため、変更せずにそのままにする必要がある点に注意してください。shared/build.gradle.ktsファイルでフレームワーク名を変更した場合は、それに応じて import ディレクティブを変更する必要があります。
Xcode から、または IntelliJ IDEA の iosApp 実行構成を使用してアプリを実行します。
