네이티브 서버
코드 예제: embedded-server-native
Ktor는 Kotlin/Native를 지원하며 추가 런타임이나 가상 머신 없이 서버를 실행할 수 있도록 해줍니다. 현재 Kotlin/Native 환경에서 Ktor 서버를 실행할 때는 다음과 같은 제한 사항이 있습니다:
Kotlin/Native 프로젝트에서 Ktor를 사용하려면 새로운 메모리 관리자(memory manager)가 필요하며, 이는 Kotlin 1.7.20부터 기본적으로 활성화되어 있습니다.
의존성 추가
Kotlin/Native 프로젝트의 Ktor 서버에는 최소 두 개의 의존성이 필요합니다:
ktor-server-core(핵심 의존성)ktor-server-cio(CIO 엔진)
다음 예제는 build.gradle.kts 파일의 nativeMain 소스 세트에 의존성을 추가합니다:
kotlin
kotlin {
sourceSets {
nativeMain.dependencies {
implementation(ktorLibs.server.core)
implementation(ktorLibs.server.cio)
}
}
} 위 코드 스니펫은 Ktor 의존성을 지정하기 위해 Ktor 버전 카탈로그를 사용합니다.
네이티브 서버를 테스트하려면 nativeTest 소스 세트에 ktor-server-test-host 아티팩트를 추가합니다:
kotlin
kotlin {
sourceSets {
nativeTest.dependencies {
implementation(libs.kotlin.test)
implementation(ktorLibs.server.testHost)
}
}
}네이티브 타깃 구성
필요한 네이티브 타깃을 지정하고 binaries 속성을 사용하여 네이티브 바이너리를 선언합니다:
kotlin
kotlin {
val hostOs = System.getProperty("os.name")
val arch = System.getProperty("os.arch")
val nativeTarget = when {
hostOs == "Mac OS X" && arch == "x86_64" -> macosX64("native")
hostOs == "Mac OS X" && arch == "aarch64" -> macosArm64("native")
hostOs == "Linux" && (arch == "x86_64" || arch == "amd64") -> linuxX64("native")
hostOs == "Linux" && arch == "aarch64" -> linuxArm64("native")
hostOs.startsWith("Windows") -> mingwX64("native")
// 지원되는 다른 타깃 목록: https://ktor.io/docs/server-native.html#targets
else -> throw GradleException("Host OS is not supported in Kotlin/Native.")
}
nativeTarget.apply {
binaries {
executable {
entryPoint = "main"
}
}
}
}전체 예제는 embedded-server-native를 참조하세요.
다음 단계
Gradle 빌드 스크립트를 구성한 후, 이어서 Ktor 서버 생성을 진행할 수 있습니다.
