빌드 도구 API
Kotlin 2.2.0은 빌드 시스템이 Kotlin 컴파일러와 통합하는 방식을 단순화하는 실험적인 빌드 도구 API(BTA)를 도입했습니다.
이전에는 빌드 시스템에 완전한 Kotlin 지원(증분 컴파일, Kotlin 컴파일러 플러그인, 데몬, Kotlin 멀티플랫폼 등)을 추가하려면 상당한 노력이 필요했습니다. BTA는 빌드 시스템과 Kotlin 컴파일러 에코시스템 간에 통합된 API를 제공함으로써 이러한 복잡성을 줄이는 것을 목표로 합니다.
BTA는 빌드 시스템이 구현할 수 있는 단일 진입점을 정의합니다. 이는 내부 컴파일러 세부 사항과 깊이 통합할 필요성을 없앱니다.
BTA 자체는 아직 빌드 도구 통합에 직접 사용할 수 있도록 공개되지 않았습니다. 제안에 관심이 있거나 피드백을 공유하고 싶다면 KEEP을 참조하세요. 구현 상태는 YouTrack에서 확인하세요.
Gradle 통합
Kotlin Gradle 플러그인(KGP)은 BTA에 대한 실험적 지원을 제공하며, 사용하려면 옵트인해야 합니다.
KGP 사용 경험에 대한 피드백을 YouTrack에 남겨주시면 감사하겠습니다.
활성화 방법
gradle.properties 파일에 다음 속성을 추가하세요.
kotlin.compiler.runViaBuildToolsApi=true다른 컴파일러 버전 구성
BTA를 사용하면 이제 KGP에서 사용하는 버전과 다른 Kotlin 컴파일러 버전을 사용할 수 있습니다. 이는 다음과 같은 경우에 유용합니다.
- 새로운 Kotlin 기능을 사용하고 싶지만 빌드 스크립트를 아직 업데이트하지 않은 경우.
- 최신 플러그인 수정이 필요하지만 당분간 이전 컴파일러 버전을 유지하고 싶은 경우.
build.gradle.kts 파일에서 이를 구성하는 방법의 예시입니다.
import org.jetbrains.kotlin.buildtools.api.ExperimentalBuildToolsApi
import org.jetbrains.kotlin.gradle.ExperimentalKotlinGradlePluginApi
plugins {
kotlin("jvm") version "2.2.0"
}
group = "org.jetbrains.example"
version = "1.0-SNAPSHOT"
repositories {
mavenCentral()
}
kotlin {
jvmToolchain(8)
@OptIn(ExperimentalBuildToolsApi::class, ExperimentalKotlinGradlePluginApi::class)
compilerVersion.set("2.1.21") // <-- different version than 2.2.0
}호환 가능한 Kotlin 컴파일러 및 KGP 버전
BTA는 다음을 지원합니다:
- 이전 세 가지 주요 Kotlin 컴파일러 버전.
- 하나의 상위 주요 버전.
예를 들어, KGP 2.2.0에서 지원되는 Kotlin 컴파일러 버전은 다음과 같습니다:
- 1.9.25
- 2.0.x
- 2.1.x
- 2.2.x
- 2.3.x
제한 사항
서로 다른 컴파일러 버전과 컴파일러 플러그인을 함께 사용하면 Kotlin 컴파일러 예외가 발생할 수 있습니다. Kotlin 팀은 향후 Kotlin 릴리스에서 이를 해결할 계획입니다.
"인-프로세스" 전략으로 증분 컴파일 활성화
KGP는 세 가지 컴파일러 실행 전략을 지원합니다. 일반적으로 인-프로세스 전략(Gradle 데몬에서 컴파일러를 실행)은 증분 컴파일을 지원하지 않습니다.
BTA를 사용하면 인-프로세스 전략이 이제 증분 컴파일을 지원합니다. 이를 활성화하려면 gradle.properties 파일에 다음 속성을 추가하세요.
kotlin.compiler.execution.strategy=in-processMaven 통합
Kotlin 2.2.0부터 BTA는 kotlin-maven-plugin에서 기본적으로 활성화됩니다.
BTA가 아직 Maven 사용자에게 직접적인 이점을 제공하지는 않지만, 다음과 같은 기능을 개발하기 위한 견고한 기반을 제공합니다: