Kotlin Multiplatform Mobile — 개념, 주요 개념 및 KMM 아키텍처

Kotlin Multiplatform Mobile이란?

Kotlin Multiplatform Mobile(KMM)은 모바일 애플리케이션의 공유 비즈니스 로직을 Kotlin으로 작성하고 코드 중복 없이 iOS와 Android에서 사용할 수 있는 기술입니다. Ionic이나 Cordova와 달리 KMM은 WebView에서 인터페이스를 렌더링하지 않습니다. UI는 완전히 네이티브로 유지되며 SwiftUI(iOS) 및 Jetpack Compose(Android)로 작성됩니다.

KMM은 2019년 JetBrains에 의해 Kotlin Multiplatform 전략의 일부로 발표되었습니다. 다른 크로스 플랫폼 솔루션과의 주요 차이점은 프레임워크가 UI를 통합하려고 하지 않고 두 플랫폼 모두에서 실제로 동일한 코드, 즉 네트워크 요청, 데이터 모델, 양식 유효성 검사, 비즈니스 규칙 및 데이터베이스 작업을 공유하는 데 중점을 둔다는 점입니다.

JetBrains 개발자 설문조사(2025)에 따르면 KMM은 모바일 개발자의 14%가 사용하고 있으며 이 수치는 매년 5%씩 증가하고 있습니다. 이 기술은 하이브리드 솔루션이 허용되지 않는 높은 성능과 네이티브 사용자 경험을 요구하는 기업에서 선택합니다.

KMM 아키텍처: 공유 모듈 및 플랫폼 구현

KMM 아키텍처는 shared(Kotlin 공통 코드), iosApp(Swift 네이티브 iOS 애플리케이션), androidApp(Kotlin 네이티브 Android 애플리케이션)의 세 가지 모듈로 구성됩니다. 공유 모듈은 Android용 JAR과 iOS용 유니버설 프레임워크(Apple Framework)로 컴파일됩니다.

공유 모듈: 공통 코드에 포함되는 내용

공유 모듈에는 모든 플랫폼 독립 계층이 포함됩니다: Ktor Client를 사용하는 네트워크 계층, kotlinx.serialization을 통한 직렬화가 포함된 데이터 모델, 데이터 관리를 위한 리포지토리, 양식 유효성 검사 및 비즈니스 규칙(예: 배송비 계산 또는 액세스 권한 확인)입니다.

공유 모듈은 Gradle Multiplatform Plugin을 사용하며 commonMain(공통 코드), androidMain(Android 관련 구현), iosMain(iOS 관련 구현)의 세 가지 소스 세트를 포함합니다. Kotlin/Native 컴파일러는 공통 코드를 iOS용 네이티브 라이브러리로 변환하며, XCFramework를 통해 Swift 프로젝트에 연결됩니다.

플랫폼 모듈

Android 모듈 — Jetpack Compose 또는 ViewBinding을 사용하는 Kotlin의 표준 Android 애플리케이션입니다. 공유 모듈은 일반 Gradle 종속성으로 연결되며 commonMain의 모든 클래스에 직접 액세스할 수 있습니다.

iOS 모듈은 Swift 또는 Objective-C의 Xcode 프로젝트입니다. 공유 모듈은 CocoaPods, Swift Package Manager 또는 XCFramework를 통해 연결됩니다. Kotlin/Native는 Kotlin 유형을 내보내기 위한 Objective-C 헤더를 생성하여 Swift에서 액세스할 수 있도록 합니다.

KMM의 expect/actual 메커니즘

expect/actual은 공유 코드에서 API를 선언하고(expect 선언) 각 플랫폼에 대해 별도로 구현을 제공하는(actual 선언) Kotlin Multiplatform 메커니즘입니다. 컴파일러는 모든 대상 플랫폼에 actual이 존재하는지 확인합니다.

expect/actual의 일반적인 사용 사례: 시간대를 고려한 현재 시간 가져오기, SharedPreferences(Android) / UserDefaults(iOS) 작업, 암호화 함수 및 UUID 생성입니다. 각 플랫폼은 자체 시스템 API를 사용합니다.

expect/actual이 없으면 통합된 비즈니스 로직 코드를 유지하는 것이 불가능합니다. 파일 시스템, 네트워크 및 스토리지 작업을 위한 API가 시스템 호출 수준에서 iOS와 Android 간에 다르기 때문입니다. 이 메커니즘은 개발자가 플랫폼별 부분을 구현하는 것을 잊지 않도록 보장합니다.

카메라나 생체 인식과 같은 플랫폼 호출의 경우 KMM은 Cordova와 유사한 플러그인과 결합된 expect/actual 메커니즘을 제공하지만 Kotlin/Native에서 작동합니다. JetBrains는 또한 날짜 및 시간 처리를 추상화하는 kotlinx-datetime 라이브러리를 출시했습니다.

KMM 코드 예제

UUID 생성을 위한 expect 함수 선언과 iOS 및 Android용 구현이 포함된 KMM 프로젝트의 기본 구조를 살펴보겠습니다.

// commonMain — 공통 선언
expect fun generateUUID(): String

// androidMain — Android 구현
actual fun generateUUID(): String {
    return java.util.UUID.randomUUID().toString()
}

// iosMain — iOS 구현
actual fun generateUUID(): String {
    return platform.Foundation.NSUUID().UUIDString
}

공유 코드에서 expect fun generateUUID()가 선언됩니다. Android는 java.util.UUID를 사용하고 iOS는 Foundation 프레임워크의 NSUUID를 사용합니다. 공유 모듈의 나머지 코드에서는 이 함수가 플랫폼에 관계없이 호출됩니다.

공유 코드에서 Ktor Client를 사용한 네트워크 요청 예제:

import io.ktor.client.*
import io.ktor.client.request.*
import io.ktor.client.statement.*
import kotlinx.serialization.*
import kotlinx.serialization.json.*

@Serializable
data class User(
    val id: Int,
    val name: String
)

class UserRepository {
    private val client = HttpClient()

    suspend fun getUser(id: Int): User {
        val response: HttpStatement =
            client.get("https://api.example.com/users/$id")
        return Json.decodeFromString(response.bodyAsText())
    }
}

이 코드는 변경 없이 두 플랫폼에서 모두 작동합니다. Ktor Client는 추가 구성 없이 Android에서는 OkHttp를, iOS에서는 NSURLSession을 자동으로 사용합니다. kotlinx.serialization을 통한 JSON 직렬화도 크로스 플랫폼입니다.

KMM과 Flutter 및 React Native 비교

KMM은 크로스 플랫폼 기술 중에서 독특한 위치를 차지하고 있습니다. Flutter 및 React Native와 달리 네이티브 UI를 대체하려고 하지 않기 때문입니다. KMM은 인터페이스를 통합하기 위한 것이 아니라 로직을 공유하기 위한 솔루션입니다.

KMM의 주요 장점은 UI를 완전히 제어할 수 있다는 것입니다. 애플리케이션이 각 플랫폼에서 네이티브처럼 보이고 작동해야 하는 경우(예: 플랫폼 애니메이션이 포함된 iOS TabBar 및 Android BottomNavigation 사용), KMM은 해결 방법 없이 이를 제공하는 유일한 크로스 플랫폼 솔루션입니다.

단점은 팀이 Kotlin, Swift, Jetpack Compose 및 SwiftUI를 동시에 알아야 하므로 채용이 어렵다는 것입니다. Flutter 및 React Native는 하나의 언어와 하나의 프레임워크에 대한 지식만 있으면 됩니다.

KMM 도입의 장점과 과제

Kotlin Multiplatform Mobile은 강력한 기술이지만 도입하려면 균형 잡힌 접근 방식이 필요합니다. 주요 장점과 팀이 직면하는 일반적인 과제를 살펴보겠습니다.

KMM의 장점

첫 번째이자 가장 중요한 장점은 코드 중복 감소입니다. JetBrains 사례 연구(2024)에 따르면 KMM을 도입한 팀은 네트워크 계층에서 60~80%, 전체 비즈니스 로직에서 40~50%의 중복 코드를 줄입니다. 이는 개발 속도와 버그 수에 직접적인 영향을 미칩니다.

두 번째 장점은 네이티브 애플리케이션 수준의 성능입니다. 하이브리드 프레임워크와 달리 KMM은 UI와 시스템 사이에 추상화 계층을 추가하지 않습니다. 비즈니스 로직 코드는 각 플랫폼에 대해 별도로 Swift나 Kotlin으로 작성된 것처럼 빠르게 실행됩니다.

도입 과제

주요 과제는 팀 역량입니다. 개발자는 Kotlin(공유 모듈용)뿐만 아니라 Swift와 Jetpack Compose(UI용)도 알아야 합니다. 보편적인 전문가를 찾기 어렵기 때문에 팀은 일반적으로 Android와 iOS 개발자로 구성되어 공유 모듈을 공동으로 유지 관리합니다.

두 번째 과제는 도구입니다. KMM은 Gradle, CocoaPods 또는 Swift Package Manager 구성뿐만 아니라 Xcode와의 통합이 필요합니다. 프로젝트 초기 단계에서는 특히 C 라이브러리 작업 시 빌드 구성 문제가 자주 발생합니다.

세 번째 과제는 디버깅입니다. Kotlin/Native와 Swift의 경계에서 버그가 발생하면 모놀리식 애플리케이션보다 원인을 찾기가 더 어렵습니다. JetBrains는 디버깅 도구를 지속적으로 개선하고 있지만 실제로 팀은 최대 20%의 시간을 인프라 작업에 사용합니다.