Skip to content

コンパイラー実行戦略 ​

Kotlinコンパイラー実行戦略(Kotlin compiler execution strategy) は、Kotlinコンパイラーがどこで実行されるかを定義します。 GradleやMavenなどのビルドツールがこの戦略を設定します。

コンパイラー実行戦略には次の2つがあります。

戦略Kotlinコンパイラーが実行される場所その他の特徴と注意事項
Kotlinデーモン独自のデーモンプロセス内GradleおよびMavenにおける デフォルトかつ最速の戦略 です。デーモンプロセスは、異なるビルドシステムプロセス間や、複数の並列コンパイル間で共有できます。
プロセス内 (In process)ビルドツールのプロセス内メモリ管理の観点からは最もシンプルな戦略ですが、JVMシステムプロパティなどの状態を共有するため、同じプロセス内で実行されている他のロジックからの分離性は低くなります。

Gradleでの設定 ​

Kotlinコンパイラーの実行戦略は、次のいずれかのプロパティを使用して定義できます。

  • kotlin.compiler.execution.strategy Gradleプロパティ
  • compilerExecutionStrategy コンパイルタスクプロパティ

Gradleプロパティを使用する ​

kotlin.compiler.execution.strategy プロパティで指定可能な値は次のとおりです。

  • daemon(デフォルト)
  • in-process

gradle.properties で kotlin.compiler.execution.strategy プロパティを設定します。

none
kotlin.compiler.execution.strategy=in-process

コンパイルタスクプロパティを使用する ​

compilerExecutionStrategy タスクプロパティは、kotlin.compiler.execution.strategy Gradleプロパティよりも優先されます。

compilerExecutionStrategy タスクプロパティで指定可能な値は次のとおりです。

ビルドスクリプトで compilerExecutionStrategy タスクプロパティを設定します。

kotlin
import org.jetbrains.kotlin.gradle.tasks.CompileUsingKotlinDaemon
import org.jetbrains.kotlin.gradle.tasks.KotlinCompilerExecutionStrategy

// ...

tasks.withType<CompileUsingKotlinDaemon>().configureEach {
    compilerExecutionStrategy.set(KotlinCompilerExecutionStrategy.IN_PROCESS)
}
groovy
import org.jetbrains.kotlin.gradle.tasks.CompileUsingKotlinDaemon
import org.jetbrains.kotlin.gradle.tasks.KotlinCompilerExecutionStrategy

// ...

tasks.withType(CompileUsingKotlinDaemon)
        .configureEach {
            compilerExecutionStrategy = KotlinCompilerExecutionStrategy.IN_PROCESS
        }

フォールバック戦略 ​

Kotlinデーモンとの通信に失敗した場合、コンパイラーは「プロセス内(In process)」戦略にフォールバックします。

このフォールバックが発生すると、Gradleはビルド出力に次の警告を表示します。

none
Failed to compile with Kotlin daemon: java.lang.RuntimeException: Could not connect to Kotlin compile daemon
[exception stacktrace]
Using fallback strategy: Compile without Kotlin daemon
Try ./gradlew --stop if this issue persists.

サイレントなフォールバックは、大量のシステムリソースを消費したり、非決定的なビルドにつながったりする可能性があります。 詳細については、こちらのYouTrackの課題を参照してください。

フォールバックを防ぐには、kotlin.daemon.useFallbackStrategy Gradleプロパティを使用します。デフォルト値は true です。 false に設定すると、デーモンの起動や通信に問題がある場合にビルドが失敗します。 このプロパティを gradle.properties で宣言します。

none
kotlin.daemon.useFallbackStrategy=false

Kotlinコンパイルタスクには useDaemonFallbackStrategy プロパティもあります。両方のプロパティを設定した場合、useDaemonFallbackStrategy プロパティが優先されます。

kotlin
tasks {
    compileKotlin {
        useDaemonFallbackStrategy.set(false)
    }
}
groovy
tasks.named("compileKotlin").configure {
    useDaemonFallbackStrategy = false
}

コンパイルを実行するのに十分なメモリがない場合、ログに関連するメッセージが表示されます。

Mavenでの設定 ​

デフォルトでは、MavenはKotlinデーモンのコンパイラー実行戦略を使用します。「プロセス内(in process)」戦略に切り替えるには、pom.xml ファイルで次のプロパティを設定します。

xml
<properties>
    <kotlin.compiler.daemon>false</kotlin.compiler.daemon>
</properties>