コンパイラー実行戦略
Kotlinコンパイラー実行戦略(Kotlin compiler execution strategy) は、Kotlinコンパイラーがどこで実行されるかを定義します。 GradleやMavenなどのビルドツールがこの戦略を設定します。
コンパイラー実行戦略には次の2つがあります。
| 戦略 | Kotlinコンパイラーが実行される場所 | その他の特徴と注意事項 |
|---|---|---|
| Kotlinデーモン | 独自のデーモンプロセス内 | GradleおよびMavenにおける デフォルトかつ最速の戦略 です。デーモンプロセスは、異なるビルドシステムプロセス間や、複数の並列コンパイル間で共有できます。 |
| プロセス内 (In process) | ビルドツールのプロセス内 | メモリ管理の観点からは最もシンプルな戦略ですが、JVMシステムプロパティなどの状態を共有するため、同じプロセス内で実行されている他のロジックからの分離性は低くなります。 |
Gradleでの設定
Kotlinコンパイラーの実行戦略は、次のいずれかのプロパティを使用して定義できます。
kotlin.compiler.execution.strategyGradleプロパティcompilerExecutionStrategyコンパイルタスクプロパティ
Gradleプロパティを使用する
kotlin.compiler.execution.strategy プロパティで指定可能な値は次のとおりです。
daemon(デフォルト)in-process
gradle.properties で kotlin.compiler.execution.strategy プロパティを設定します。
kotlin.compiler.execution.strategy=in-processコンパイルタスクプロパティを使用する
compilerExecutionStrategy タスクプロパティは、kotlin.compiler.execution.strategy Gradleプロパティよりも優先されます。
compilerExecutionStrategy タスクプロパティで指定可能な値は次のとおりです。
DAEMON(デフォルト)IN_PROCESS
ビルドスクリプトで compilerExecutionStrategy タスクプロパティを設定します。
import org.jetbrains.kotlin.gradle.tasks.CompileUsingKotlinDaemon
import org.jetbrains.kotlin.gradle.tasks.KotlinCompilerExecutionStrategy
// ...
tasks.withType<CompileUsingKotlinDaemon>().configureEach {
compilerExecutionStrategy.set(KotlinCompilerExecutionStrategy.IN_PROCESS)
}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はビルド出力に次の警告を表示します。
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 で宣言します。
kotlin.daemon.useFallbackStrategy=falseKotlinコンパイルタスクには useDaemonFallbackStrategy プロパティもあります。両方のプロパティを設定した場合、useDaemonFallbackStrategy プロパティが優先されます。
tasks {
compileKotlin {
useDaemonFallbackStrategy.set(false)
}
}tasks.named("compileKotlin").configure {
useDaemonFallbackStrategy = false
}コンパイルを実行するのに十分なメモリがない場合、ログに関連するメッセージが表示されます。
Mavenでの設定
デフォルトでは、MavenはKotlinデーモンのコンパイラー実行戦略を使用します。「プロセス内(in process)」戦略に切り替えるには、pom.xml ファイルで次のプロパティを設定します。
<properties>
<kotlin.compiler.daemon>false</kotlin.compiler.daemon>
</properties>