Skip to content

컴파일러 실행 전략 ​

_Kotlin 컴파일러 실행 전략(Kotlin compiler execution strategy)_은 Kotlin 컴파일러가 실행되는 위치를 정의합니다. Gradle 또는 Maven과 같은 빌드 도구가 이 전략을 구성합니다.

두 가지 컴파일러 실행 전략이 있습니다:

전략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" 전략으로 대체(fallback)됩니다.

이러한 폴백이 발생하면 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.

사용자 모르게 발생하는 폴백(silent fallback)은 많은 시스템 리소스를 소모하거나 비결정적(non-deterministic) 빌드로 이어질 수 있습니다. 자세한 내용은 이 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>