KMM 프로젝트 구조
공유 코드와 플랫폼 코드
KMM 프로젝트 구조은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
KMM이란 무엇인가요
코틀린 멀티플랫폼 모바일(KMM)을 사용하면 플랫폼별 사용자 인터페이스는 유지하면서 iOS와 안드로이드 간에 코드를 공유할 수 있습니다. 코틀린으로 업무 로직을 한 번만 작성하면 됩니다.
공유 모듈
KMM 프로젝트의 중심에는 공유 모듈이 있습니다. 이 모듈은 안드로이드용 JVM 라이브러리와 iOS용 플랫폼 프레임워크로 컴파일됩니다.
- 안드로이드에서는 일반 의존성으로 사용합니다
- iOS에서는 Objective-C/Swift 프레임워크로 가져옵니다
소스 집합
공유 모듈은 다음 소스 집합으로 나뉩니다:
commonMain— 공유되는 플랫폼 독립적 코드androidMain— 안드로이드 전용 코드iosMain— iOS 전용 코드
commonMain
commonMain에서는 코틀린 표준 라이브러리와 다중 플랫폼 라이브러리만 사용할 수 있습니다. 안드로이드 또는 iOS API를 직접 참조해서는 안 됩니다.
// shared/src/commonMain/kotlin/Greeting.kt
class Greeting {
fun greet(): String = "Hello, KMM!"
}대상 구성
공유 모듈의 build.gradle.kts에서 다중 플랫폼 플러그인을 사용해 빌드할 플랫폼을 선언합니다.
kotlin {
androidTarget()
iosX64()
iosArm64()
iosSimulatorArm64()
}iOS 프레임워크
iOS 대상은 Xcode가 가져오는 하나의 프레임워크로 묶입니다.
kotlin {
listOf(iosX64(), iosArm64(), iosSimulatorArm64()).forEach {
it.binaries.framework {
baseName = "Shared"
}
}
}공통 의존성
다중 플랫폼 라이브러리(코루틴, 직렬화, Ktor)는 모든 대상에서 공유할 수 있도록 commonMain에 추가합니다.
sourceSets {
val commonMain by getting {
dependencies {
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.1")
}
}
}안드로이드 앱 모듈
안드로이드 앱 모듈은 다른 Gradle 모듈과 마찬가지로 shared에 의존하며, Jetpack Compose 또는 뷰를 사용해 안드로이드 사용자 인터페이스를 빌드합니다.
// androidApp/build.gradle.kts
dependencies {
implementation(project(":shared"))
}iOS 앱
iOS 앱은 표준 Xcode 프로젝트입니다. 생성된 Shared 프레임워크를 연결하고 Swift에서 코틀린 클래스를 호출합니다.
// Swift
// import Shared
// let text = Greeting().greet()공유할 항목
일반적으로 공유하는 코드에는 네트워킹, 데이터 모델, 저장소, 사용 사례, 유효성 검사가 있습니다. 사용자 인터페이스, 탐색, 플랫폼 센서는 플랫폼별로 유지합니다.
독립 실행형 Greeting
공유 로직은 순수한 코틀린으로 작성됩니다. 다음은 이것이 일반적인 코드임을 보여 주기 위해 동일한 클래스를 독립적으로 실행하는 예입니다.
class Greeting {
fun greet(): String = "Hello, KMM!"
}
fun main() {
println(Greeting().greet())
}빠른 확인
안드로이드 또는 iOS API를 전혀 참조하지 않아야 하는 코드는 어디에 작성합니까?
복습
KMM의 구조를 배웠습니다:
commonMain,androidMain,iosMain으로 구성된shared모듈- 다중 플랫폼 플러그인에서 대상 선언, iOS에는 프레임워크 생성
- 안드로이드는
project(":shared")를 통해 의존하고, iOS는 프레임워크를 가져옴
다음: expect와 actual
자주 묻는 질문
“KMM 프로젝트 구조” 강의는 무료인가요?
네 — “KMM 프로젝트 구조” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“KMM 프로젝트 구조”에서 뭘 배우나요?
공유 코드와 플랫폼 코드 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“KMM 프로젝트 구조” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- KMM 프로젝트 구조
- expect와 actual
- 비즈니스 로직 공유
- 플랫폼 API