原生服务器

原生服务器

代码示例： embedded-server-native

Ktor 支持 Kotlin/Native，并允许您在没有额外运行时或虚拟机的环境下运行服务器。目前，在 Kotlin/Native 下运行 Ktor 服务器具有以下限制：

• 应使用 embeddedServer 创建服务器
• 仅支持 CIO 引擎
• 不支持不带反向代理的 HTTPS

undefined

添加依赖项

Kotlin/Native 项目中的 Ktor 服务器至少需要两个依赖项：

• ktor-server-core（核心依赖项）
• ktor-server-cio（CIO 引擎）

下面的代码片段展示了如何在 build.gradle.kts 文件中向 nativeMain 源集添加依赖项：

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

要测试原生服务器，请将 ktor-server-test-host 构件添加到 nativeTest 源集中：

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

配置原生目标

使用 binaries 属性指定所需的原生目标并声明原生二进制文件：

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 服务器。