Skip to content
Beta

Build tools API

BTA는 Kotlin/JVM, Kotlin/JS 및 Kotlin/Wasm을 지원합니다.

현재 Kotlin/Native는 지원하지 않습니다.

Kotlin에는 빌드 시스템과 Kotlin 컴파일러의 통합을 간소화하는 Build tools API(BTA)가 있습니다.

빌드 시스템에 Kotlin에 대한 완전한 지원(증분 컴파일, Kotlin 컴파일러 플러그인, 데몬, Kotlin 멀티플랫폼 등)을 추가하려면 상당한 노력이 필요합니다. BTA는 빌드 시스템과 Kotlin 컴파일러 에코시스템 사이에 통합된 API를 제공하여 이러한 복잡성을 줄이는 것을 목표로 합니다.

BTA는 빌드 시스템이 구현할 수 있는 단일 진입점(entry point)을 정의합니다. 이를 통해 컴파일러의 내부 세부 사항과 깊게 통합할 필요가 없어집니다.

타깃에 따라 안정성 수준이 다릅니다. Kotlin/JVM의 경우 BTA는 베타(Beta)이고, Kotlin/JS 및 Kotlin/Wasm의 경우 알파(Alpha)입니다. 자세한 내용은 Build tools API (BTA)를 참고하세요. BTA를 사용하려면 @OptIn(ExperimentalBuildToolsApi::class)를 통한 옵트인이 필요합니다.

제안에 관심이 있거나 의견을 공유하고 싶다면 KEEP을 확인하세요. 구현 상태는 YouTrack에서 확인할 수 있습니다.

Gradle과의 통합 ​

Kotlin Gradle 플러그인(KGP)은 Kotlin/JVM 컴파일에 기본적으로 BTA를 사용합니다.

KGP 사용 경험에 대한 피드백은 YouTrack을 통해 언제든지 보내주세요.

Alpha

Kotlin/JS, Kotlin/Wasm 및 Kotlin 메타데이터에 BTA 활성화

Kotlin 2.4.20부터 KGP는 BTA를 통해 Kotlin/JS, Kotlin/Wasm 및 Kotlin 메타데이터 컴파일도 실행할 수 있습니다. 이를 통해 KGP가 컴파일러와 더욱 일관되게 상호작용하며, 일부 경우에는 컴파일 속도가 빨라지고 안정성이 향상됩니다.

Kotlin 2.4.20에서는 이러한 타깃이 옵트인 방식으로 제공됩니다. 사용해 보려면 gradle.properties 파일에 해당 속성을 추가하세요:

none
kotlin.js.runViaBuildToolsApi = true
kotlin.wasm.runViaBuildToolsApi = true
kotlin.metadata.runViaBuildToolsApi = true

다른 컴파일러 버전 구성하기 ​

BTA를 사용하면 이제 KGP에서 사용하는 버전과 다른 버전의 Kotlin 컴파일러를 사용할 수 있습니다. 이는 다음과 같은 경우에 유용합니다:

  • 새로운 Kotlin 기능을 사용해보고 싶지만 빌드 스크립트를 아직 업데이트하지 않은 경우.
  • 최신 플러그인 수정 사항은 필요하지만 당분간은 이전 컴파일러 버전을 유지하고 싶은 경우.

다음은 build.gradle.kts 파일에서 이를 구성하는 예시입니다:

kotlin
import org.jetbrains.kotlin.buildtools.api.ExperimentalBuildToolsApi
import org.jetbrains.kotlin.gradle.ExperimentalKotlinGradlePluginApi

plugins {
    kotlin("jvm") version "2.4.20"
}

group = "org.jetbrains.example"
version = "1.0-SNAPSHOT"

repositories {
    mavenCentral()
}

kotlin {
    jvmToolchain(8)
    @OptIn(ExperimentalBuildToolsApi::class, ExperimentalKotlinGradlePluginApi::class)
    compilerVersion.set("2.3.21") // <-- 2.4.20과 다른 버전을 설정
}

호환되는 Kotlin 컴파일러 및 KGP 버전 ​

BTA는 다음 버전을 지원합니다:

  • 이전 세 개의 주요(major) Kotlin 컴파일러 버전.
  • 향후 한 개의 주요 버전.

예를 들어, KGP 2.2.0에서 지원되는 Kotlin 컴파일러 버전은 다음과 같습니다:

  • 1.9.25
  • 2.0.x
  • 2.1.x
  • 2.2.x
  • 2.3.x

제한 사항 ​

다른 컴파일러 버전을 컴파일러 플러그인과 함께 사용하면 Kotlin 컴파일러 예외가 발생할 수 있습니다. Kotlin 팀은 향후 Kotlin 릴리스에서 이 문제를 해결할 계획입니다.

'인프로세스(in-process)' 전략을 사용한 증분 컴파일 활성화 ​

KGP는 세 가지 컴파일러 실행 전략을 지원합니다. 일반적으로 "인프로세스(in-process)" 전략(Gradle 데몬 내에서 컴파일러를 실행)은 증분 컴파일을 지원하지 않습니다.

BTA를 사용하면 "인프로세스" 전략에서도 증분 컴파일을 지원합니다. 이를 활성화하려면 gradle.properties 파일에 다음 속성을 추가하세요:

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

Maven과의 통합 ​

BTA는 kotlin-maven-plugin이 기본 컴파일러 실행 전략인 Kotlin 데몬을 지원할 수 있도록 합니다. kotlin-maven-plugin은 기본적으로 BTA를 사용하므로 별도의 구성이 필요하지 않습니다.

BTA를 통해 향후 증분 컴파일 안정화와 같은 더 많은 기능을 제공할 수 있게 될 것입니다.