기본 설정

java{
    toolchain{
        languageVersion = JavaLanguageVersion.of(17)
    }
}

Java Toolchain은 특정 버전의 JDK(Java Development Kit)를 자동으로 설치하고 관리하는 도구입니다.
Toolchain을 설정하면 프로젝트의 일관된 실행 환경을 보장할 수 있습니다.

Gradle 6.7 버전부터 지원했고, 8.0 버전부터 Toolchain Resolver Plugin 기능을 추가 제공합니다.
Kotlin은 1.5.30 버전부터 제공됩니다.

특징

• 프로젝트 JDK 자동 설정
  • 프로젝트에 설정된 버전이 적용되거나 없으면 다운로드 합니다.
• 개발 환경 일관성 보장
  • 동일한 실행 환경을 보장해서 버전에 따른 이슈를 방지합니다.
• 다중 JDK 지원
  • 동일한 프로젝트에서 여러 JDK 버전을 사용할 수 있지만 권장하지 않습니다.
• 빌드 설정 간소화
  • Gradle에서 자동으로 JDK 버전과 주요 설정을 관리합니다.

Java Toolchain 오류는 대부분 버전 이슈입니다.
IDE에 설정된 빌드나 컴파일 버전이 Toolchain에 설정된 버전과 다르면 오류가 발생합니다.

오류 예제

컴파일 버전이 없는데 빌드를 시도한 경우

Failed to calculate the value of task ':compileJava' property 'javaCompiler'.
Cannot find a Java installation on your machine matching this tasks requirements: {languageVersion=22, vendor=any vendor, implementation=vendor-specific} for MAC_OS on x86_64.
No locally installed toolchains match and toolchain download repositories have not been configured.

프로젝트에 설정된 컴파일 버전이 다른 경우

Inconsistent JVM-target compatibility detected for tasks 'compileJava' (23) and 'compileKotlin' (21).

관련 문서

Toolchain Guide