0Pricing
Kotlin Academy · 강의

expect와 actual

플랫폼별 구현

expect와 actual은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

플랫폼 코드가 필요한 이유

일부 기능에는 공통 구현이 없습니다. 예를 들어 OS 이름, UUID 또는 현재 플랫폼을 가져오는 기능이 그렇습니다. KMM은 expect/actual 메커니즘으로 이를 해결합니다.

expect 선언

commonMain에서는 본문이 없는 계약인 expect 함수 또는 클래스를 선언합니다. 공통 코드에서 이를 호출할 수 있습니다.

// commonMain
expect fun platformName(): String

안드로이드의 actual

각 플랫폼은 시그니처가 일치하는 actual 구현을 제공합니다.

// androidMain
actual fun platformName(): String = "Android " + android.os.Build.VERSION.SDK_INT

iOS의 actual

iOS 소스 집합은 네이티브 API를 사용하여 자체 버전을 제공합니다.

// iosMain
import platform.UIKit.UIDevice

actual fun platformName(): String =
    UIDevice.currentDevice.systemName + " " + UIDevice.currentDevice.systemVersion

공통 코드에서 사용하기

공통 코드는 expected 함수가 존재하는 것처럼 호출하고, 컴파일러는 대상별로 올바른 actual을 연결합니다.

// commonMain
class Platform {
    val name: String get() = platformName()
}

expect 클래스

전체 클래스를 expect할 수 있습니다. 각 플랫폼은 멤버가 일치하는 actual 클래스를 제공합니다.

// commonMain
expect class FileReader(path: String) {
    fun read(): String
}

actual 클래스 구현

플랫폼은 네이티브 파일 API를 사용하여 expected 클래스를 구현합니다(예: 안드로이드의 Java IO, iOS의 Foundation).

// androidMain
actual class FileReader actual constructor(private val path: String) {
    actual fun read(): String = java.io.File(path).readText()
}

typealias를 사용한 expect

actual은 기존 플랫폼 형식에 대한 typealias가 될 수 있으므로 래퍼가 필요하지 않습니다.

// commonMain
expect class Uuid

// jvm/androidMain
actual typealias Uuid = java.util.UUID

시그니처 일치 규칙

actual은 expect와 정확히 일치해야 합니다. 이름, 매개변수, 반환 형식이 모두 같아야 합니다. 일치하지 않으면 컴파일 오류가 발생하여 플랫폼 간 일관성이 보장됩니다.

expect/actual을 사용하지 않을 때

추상화가 더 유연해야 한다면 런타임에 주입하는 단순한 인터페이스와 플랫폼별 구현을 우선하세요. expect/actual은 작고 고정된 플랫폼 기본 기능에만 사용하세요.

공통 코드 예시

KMM 외부에서는 같은 개념이 단순히 추상화를 호출하는 것입니다. 여기서는 일반 함수가 플랫폼 호출을 대신합니다.

fun platformName(): String = "Demo Platform"

fun main() {
    println("Running on " + platformName())
}

빠른 확인

expect 선언은 어디에 작성하고, 해당 actual 구현은 어디에 작성합니까?

복습

expect/actual은 플랫폼 간 차이를 연결합니다:

  • expect는 commonMain에서 계약을 선언합니다
  • actual은 플랫폼별로 구현하거나 typealias를 통해 구현합니다
  • 시그니처는 정확히 일치해야 합니다
  • 유연한 추상화에는 인터페이스를 우선하세요

다음: 업무 로직 공유

자주 묻는 질문

“expect와 actual” 강의는 무료인가요?

네 — “expect와 actual” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“expect와 actual”에서 뭘 배우나요?

플랫폼별 구현 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“expect와 actual” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. KMM 프로젝트 구조
  2. expect와 actual
  3. 비즈니스 로직 공유
  4. 플랫폼 API
← Kotlin Academy(으)로 돌아가기