권장 Kotlin Multiplatform 프로젝트 구조
기본 및 고급 프로젝트 구조 개념에 대한 개요를 통해 소스 세트(source set)와 의존성 관리에 대해 이해하셨을 것입니다. 그렇다면 소스 세트를 구성하고 의존성을 활용하는 모듈은 어떻게 구성해야 할까요?
이 문서는 KMP 프로젝트를 중심으로 다룹니다. 모듈화에 관한 전반적인 의사 결정 방식을 이해하려면 Android 모듈화 가이드를 참조하세요.
최적의 모듈 구조
최적의 모듈 구조는 목표와 필요한 타깃에 따라 달라질 수 있습니다. 다양한 구성과 타깃 세트로 KMP IDE 플러그인 마법사의 출력 결과를 살펴보면 기본적으로 프로젝트가 어떻게 구성되는지 확인할 수 있습니다.
일반적인 접근 방식은 다음과 같습니다:
- 앱의 진입점(entry point)은 별도의 모듈에 포함되어야 하며, 각 진입점 모듈은 필요한 공유 코드 모듈에 의존해야 합니다.
- 공유 코드는 일반적으로 비즈니스 로직과 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) } }composeApp/build.gradle.kts파일에서 Android 관련 설정이 포함된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 라이브러리로 변경합니다.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/디렉터리로 이동하되, 크로스 플랫폼으로 유지되어야 하는 코드를 염두에 두어야 합니다:- 예제에서의
MainActivity.kt와 같은 진입점 코드는 Android 앱을 올바르게 빌드하기 위해 반드시androidApp모듈에 있어야 합니다. - 모든 expected 및 actual 선언은 모든 플랫폼에서 사용할 수 있도록 공통 모듈(이 예제에서는
composeApp)의 소스 세트에 남아 있어야 합니다.androidApp이composeApp에 의존하도록 설정했으므로, 이러한 선언들은 진입점 코드에서도 사용할 수 있게 됩니다.
- 예제에서의
androidApp/src/androidMain디렉터리의 이름을main으로 변경합니다.모든 것이 올바르게 구성되었다면
androidApp/src/main/.../MainActivity.kt파일의 import가 정상적으로 동작하며 코드가 컴파일됩니다.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파일에 데스크톱 앱 모듈에 필요한 플러그인을 지정합니다: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파일의 import가 정상적으로 동작하며 코드가 컴파일됩니다. - 데스크톱 앱을 실행하려면 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()타깃 선언.
웹 앱
웹 앱 모듈 생성 및 구성
웹 앱 모듈(webApp)을 생성하려면:
프로젝트 루트에
webApp디렉터리를 생성합니다.해당 디렉터리 내에 빈
build.gradle.kts파일과src디렉터리를 생성합니다.settings.gradle.kts파일 끝에 다음 줄을 추가하여 새 모듈을 프로젝트 설정에 추가합니다:kotlininclude(":webApp")
웹 앱용 빌드 스크립트 구성
웹 앱 빌드 스크립트가 동작하도록 설정하려면:
webApp/build.gradle.kts파일에 필요한 플러그인을 지정합니다:```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파일의 JavaScript 및 Wasm 타깃 선언을webApp/build.gradle.kts파일의kotlin {}블록으로 복사합니다: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 새로고침 버튼을 클릭합니다.
코드 이동 및 웹 앱 실행
구성이 완료되면 웹 앱 코드를 새 디렉터리로 이동합니다:
composeApp/src/webMain디렉터리 전체를webApp/src디렉터리로 이동합니다. 모든 것이 올바르게 구성되었다면webApp/src/webMain/.../main.kt파일의 import가 정상적으로 동작하며 코드가 컴파일됩니다.webApp/src/webMain/resources/index.html파일에서 스크립트 이름을composeApp.js에서webApp.js로 업데이트합니다.- 웹 앱을 실행하려면 composeApp [wasmJs] 실행 구성을 수정합니다:
- 실행 구성 드롭다운에서 Edit Configurations를 선택합니다.
- Gradle 카테고리에서 composeApp [wasmJs] 구성을 찾습니다.
- Gradle project 필드에서
ComposeDemo:composeApp을ComposeDemo:webApp으로 변경합니다.
- JavaScript 버전도 실행할 수 있도록 composeApp [js]에 대해서도 동일하게 반복합니다.
- 실행 구성을 시작하여 앱이 예상대로 실행되는지 확인합니다.
- 모든 것이 올바르게 동작한다면:
composeApp/src/webMain디렉터리를 삭제합니다.composeApp/build.gradle.kts파일에서 웹 관련 코드를 제거합니다:- Kotlin
sourceSets {}블록 내부의webMain.dependencies {}블록, kotlin {}블록 내부의js {}및wasmJs {}타깃 선언.
- Kotlin
공통(shared) 모듈 구성
예제 앱에서는 UI와 비즈니스 로직 코드가 모두 공유되므로 모든 공통 코드를 담기 위해 단 하나의 공유 모듈만 필요합니다. 단순히 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 코드와 분리할 수 없습니다.
예를 들어 모든 UI 코드를 공유하지 않아 프로젝트에 이미 shared 모듈이 있는 경우, 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 } } }공통 및 JavaScript 소스 세트에 필요한 시간 관련 의존성을
composeApp에 선언된 방식과 동일하게 추가합니다: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()함수를 import하여 코드를 수정합니다.애플리케이션을 실행하여 새 모듈이 정상적으로 작동하는지 확인합니다.
공유 로직을 별도의 모듈로 성공적으로 격리하여 크로스 플랫폼에서 사용하도록 설정했습니다. 다음 단계는 공유 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 코드에서 import할 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 } } }공유 UI에 필요한 의존성을
composeApp에 선언된 방식과 동일하게 추가합니다: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 모듈이 올바르게 작동하는지 테스트할 수 있습니다.이제 리소스가 다른 패키지에 위치하므로 리소스 import를 제외하고 새
App.kt파일이 정상적으로 작동해야 합니다. 올바른 경로로Res객체와 모든 drawable 리소스를 다시 import합니다. 예:변경 전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파일의 import 문은 모듈의 실제 이름이 아니라 iOS 타깃의 Gradle 설정에 있는baseName매개변수와 일치하므로 그대로 유지해야 합니다.shared/build.gradle.kts파일에서 프레임워크 이름을 변경하는 경우, import 지시문도 그에 맞게 변경해야 합니다.
Xcode에서 앱을 실행하거나 IntelliJ IDEA의 iosApp 실행 구성을 사용하여 앱을 실행합니다.
