플랫폼 API
네이티브 기능에 접근합니다
플랫폼 API은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
네이티브 기능에 접근하기
공유 코드는 저장소, 설정, 시계, 네트워크 엔진 같은 기기 기능에 접근해야 할 때가 있습니다. KMM은 네이티브 API에 깔끔하게 접근할 수 있는 여러 방법을 제공합니다.
기본 타입에 expect/actual 사용하기
플랫폼별로 다른 간단한 값을 사용할 때는 expect/actual을 사용합니다. 공통 코드는 깔끔하게 유지하고, 각 플랫폼에서 세부 내용을 채울 수 있습니다.
// commonMain
expect fun currentTimeMillis(): Long
// androidMain
actual fun currentTimeMillis(): Long = System.currentTimeMillis()플랫폼 코드의 의존성 주입
더 유연한 방법은 공통 코드에 인터페이스를 정의하고, 각 앱에서 플랫폼 구현을 주입하는 것입니다.
// commonMain
interface Storage {
fun save(key: String, value: String)
fun load(key: String): String?
}Android 구현
Android는 SharedPreferences를 사용해 인터페이스를 구현하고, 이를 공유 코드에 제공합니다.
// androidMain
import android.content.SharedPreferences
class AndroidStorage(private val prefs: SharedPreferences) : Storage {
override fun save(key: String, value: String) {
prefs.edit().putString(key, value).apply()
}
override fun load(key: String): String? = prefs.getString(key, null)
}iOS 구현
iOS는 Foundation 프레임워크의 NSUserDefaults를 사용해 같은 인터페이스를 구현합니다.
// iosMain
import platform.Foundation.NSUserDefaults
class IosStorage : Storage {
private val defaults = NSUserDefaults.standardUserDefaults
override fun save(key: String, value: String) = defaults.setObject(value, key)
override fun load(key: String): String? = defaults.stringForKey(key)
}네이티브 iOS API 호출하기
iosMain에서는 Apple 프레임워크를 직접 호출할 수 있습니다. Kotlin/Native가 해당 프레임워크에 대한 상호 운용 바인딩을 생성하기 때문입니다.
import platform.UIKit.UIDevice
fun deviceModel(): String = UIDevice.currentDevice.modelAndroid API 호출하기
androidMain에는 전체 Android SDK를 사용할 수 있습니다. Android 플랫폼을 대상으로 컴파일하기 때문입니다.
import android.os.Build
fun deviceModel(): String = Build.MODEL바로 사용할 수 있는 멀티플랫폼 라이브러리
대부분의 경우 맞춤형 상호 운용 기능을 직접 만들 필요가 없습니다. 라이브러리가 이미 일반적인 기능을 감싸서 제공합니다.
- multiplatform-settings — 키-값 저장소
- Ktor — 네트워킹
- SQLDelight — 로컬 데이터베이스
구현 제공하기
일반적으로 Koin 같은 DI 프레임워크를 통해 앱이 시작될 때 플랫폼 구현을 주입합니다. 그러면 공유 코드가 올바른 구현을 받습니다.
// Android: provide AndroidStorage(prefs)
// iOS: provide IosStorage()
// Shared Repository(storage) uses whichever was injected접근 방식 선택하기
가이드라인은 다음과 같습니다.
- 작은 값 →
expect/actual - 메서드가 여러 개인 동작 → 인터페이스 + 주입
- 공통으로 필요한 기능 → 기존 멀티플랫폼 라이브러리 사용
실행 가능한 추상화 예제
인터페이스 방식은 일반적인 Kotlin 코드로 구현할 수 있습니다. 여기서는 메모리 내 구현이 플랫폼 저장소를 대신합니다.
interface Storage {
fun save(key: String, value: String)
fun load(key: String): String?
}
class MemoryStorage : Storage {
private val map = mutableMapOf<String, String>()
override fun save(key: String, value: String) { map[key] = value }
override fun load(key: String): String? = map[key]
}
fun main() {
val s: Storage = MemoryStorage()
s.save("name", "Ada")
println(s.load("name"))
}빠른 확인
여러 메서드가 있고 플랫폼마다 다르게 구현해야 하며 쉽게 테스트할 수 있는 저장소 기능이 필요합니다. 어떤 접근 방식이 권장되나요?
요약
다음과 같이 네이티브 기능에 깔끔하게 접근할 수 있습니다.
- 기본 값에는
expect/actual사용 - 동작에는 공통 인터페이스 + 주입된 플랫폼 구현 사용
androidMain/iosMain에서 직접 상호 운용- 가능하면 멀티플랫폼 라이브러리 재사용
이것으로 KMM 기초 과정을 마칩니다.
AI 튜터와 함께 Kotlin을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 51
- 레슨
- 203
자주 묻는 질문
“플랫폼 API” 강의는 무료인가요?
네 — “플랫폼 API” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“플랫폼 API”에서 뭘 배우나요?
네이티브 기능에 접근합니다 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“플랫폼 API” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.