Skip to content

네이티브 서버 ​

Ktor는 Kotlin/Native를 지원하며 추가 런타임이나 가상 머신 없이 서버를 실행할 수 있도록 해줍니다. 현재 Kotlin/Native 환경에서 Ktor 서버를 실행할 때는 다음과 같은 제한 사항이 있습니다:

  • embeddedServer를 사용하여 서버를 생성해야 합니다.
  • CIO 엔진만 지원됩니다.
  • 리버스 프록시(reverse proxy) 없는 HTTPS는 지원되지 않습니다.

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 서버 생성을 진행할 수 있습니다.