네이티브 서버

코드 예시: embedded-server-native

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

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

의존성 추가

Kotlin/Native 프로젝트의 Ktor 서버는 최소 두 가지 의존성을 필요로 합니다: ktor-server-core 의존성과 엔진 의존성(CIO). 아래 코드 스니펫은 build.gradle.kts 파일의 nativeMain 소스 세트에 의존성을 추가하는 방법을 보여줍니다:

sourceSets {
    val nativeMain by getting {
        dependencies {
            implementation("io.ktor:ktor-server-core:$ktor_version")
            implementation("io.ktor:ktor-server-cio:$ktor_version")
        }
    }
}

네이티브 서버를 테스트하려면 ktor-server-test-host 아티팩트를 nativeTest 소스 세트에 추가합니다:

sourceSets {
    val nativeTest by getting {
        dependencies {
            implementation(kotlin("test"))
            implementation("io.ktor:ktor-server-test-host:$ktor_version")
        }
    }
}

네이티브 타겟 구성

필요한 네이티브 타겟을 지정하고 binaries 속성을 사용하여 네이티브 바이너리를 선언합니다:

    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" -> linuxX64("native")
        hostOs == "Linux" && arch == "aarch64" -> linuxArm64("native")
        // Other supported targets are listed here: https://ktor.io/docs/native-server.html#targets
        else -> throw GradleException("Host OS is not supported in Kotlin/Native.")
    }

    nativeTarget.apply {
        binaries {
            executable {
                entryPoint = "main"
            }
        }
    }

전체 예시는 다음에서 찾을 수 있습니다: embedded-server-native.

서버 생성

Gradle 빌드 스크립트를 구성한 후, 서버 생성에 설명된 대로 Ktor 서버를 생성할 수 있습니다.