Skip to content

ネイティブサーバー ​

KtorはKotlin/Nativeをサポートしており、追加のランタイムや仮想マシンなしでサーバーを実行できます。現在、Kotlin/Native環境でKtorサーバーを実行することには、以下の制限事項があります:

Kotlin/NativeプロジェクトでKtorを使用するには、新しいメモリマネージャーが必要です。これはKotlin 1.7.20以降でデフォルトで有効になっています。

依存関係の追加 ​

Kotlin/NativeプロジェクトのKtorサーバーには、少なくとも2つの依存関係が必要です:

  • 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")
        // Other supported targets are listed here: 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サーバーの作成に進むことができます。