Gradle에서 Java 버전을 설정하는 방법은 무엇인가요?

1. Q: Gradle에서 Java 버전을 설정해야 하는 이유는 무엇인가요?
A:
- 소스 코드 문법 호환성 확보 (예: var, record 등)
- 컴파일 결과 바이너리의 실행 환경(target JVM) 보장
- CI/CD 파이프라인과 개발자 로컬 환경 일관성 유지

2. Q: 기본 Java 플러그인을 이용해 버전을 설정하려면 어떻게 하나요?
A: build.gradle(Groovy DSL) 또는 build.gradle.kts(Kotlin DSL)에 다음을 추가합니다.
Groovy DSL:
```groovy
plugins {
id 'java'
}

java {
sourceCompatibility = JavaVersion.VERSION_11
targetCompatibility = JavaVersion.VERSION_11
}
```
Kotlin DSL:
```kotlin
plugins {
java
}

java {
sourceCompatibility = JavaVersion.VERSION_11
targetCompatibility = JavaVersion.VERSION_11
}
```

3. Q: 소스와 타깃 버전을 따로 지정해야 하나요?
A:
- sourceCompatibility: 컴파일 시 사용할 소스 문법 버전
- targetCompatibility: 생성된 클래스 파일의 최소 실행 JVM 버전
둘을 같게 설정하는 것이 일반적이며, 호환성을 위해 필요에 따라 다르게 설정할 수 있습니다.

4. Q: Gradle Toolchains를 이용하면 무엇이 좋은가요?
A:
- 로컬에 설치된 JDK에 의존하지 않고 Gradle이 JDK를 자동 다운로드/관리
- 멀티 JDK 빌드를 손쉬운 구성
- CI 환경에서 JDK 버전 통일성 보장

5. Q: Toolchains를 사용해 Java 17을 설정하는 방법은?
A: build.gradle(Groovy DSL) 예시:
```groovy
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
```
Kotlin DSL:
```kotlin
java { toolchain {
languageVersion.set(JavaLanguageVersion.of(17))
}
}
```

6. Q: 하위 프로젝트에 전역으로 Java 버전을 적용하려면?
A: settings.gradle 또는 루트 build.gradle에서 allprojects 또는 subprojects 블록 사용:
```groovy
subprojects {
apply plugin: 'java'

java {
sourceCompatibility = JavaVersion.VERSION_11
targetCompatibility = JavaVersion.VERSION_11
}
}
```

7. Q: 개별 컴파일 태스크에만 버전을 지정할 수 있나요?
A: 가능하며, compileJava 태스크에 직접 설정합니다.
```groovy
tasks.named('compileJava', JavaCompile) {
sourceCompatibility = '1.8'
targetCompatibility = '1.8'
}
```

8. Q: Gradle Wrapper와 Java 버전은 어떻게 연동되나요?
A:
- Gradle Wrapper(gradlew)는 Gradle 버전을 고정
- java.version 속성이나 toolchain이 선언된 JDK로 빌드
- wrapper에 JDK 버전 지정 옵션은 없으므로, wrapper 배포 시 README에 JDK 요구사항 명시

9. Q: 빌드 도중 “Unsupported class file major version” 에러 해결책은?
A:
- sourceCompatibility/targetCompatibility 버전이 낮아서 발생
- 필요한 버전(예: 17)으로 올리거나 toolchain에 해당 JDK 설치
- Gradle 데몬 재시작(`gradle --stop`) 후 재빌드

10. Q: 결론 및 대표 예제
A:
```
plugins {
id 'java'
}

java {
toolchain {
languageVersion = JavaLanguageVersion.of(11)
}
sourceCompatibility = JavaVersion.VERSION_11
targetCompatibility = JavaVersion.VERSION_11
}
```
위 설정으로 소스/타깃 호환성과 자동 JDK 관리를 동시에 확보할 수 있습니다.

Gradle에서 Java 버전을 설정하는 방법은 여러 가지가 있으며, 프로젝트의 요구 사항에 따라 적절한 방법을 선택할 수 있습니다. Java 버전을 설정하는 것은 Gradle 빌드 스크립트에서 Java 컴파일러와 런타임 환경을 지정하는 데 중요합니다. 아래에서는 Gradle에서 Java 버전을 설정하는 다양한 방법을 자세히 설명하겠습니다. 1. Gradle Wrapper 사용 Gradle Wrapper를 사용하면 프로젝트에 특정 Gradle 버전을 고정할 수 있으며, 이를 통해 Java 버전도 쉽게 관리할 수 있습니다. Gradle Wrapper를 설정하려면 다음 명령어를 사용합니다: ```bash gradle wrapper --gradle-version ``` 이 명령어는 프로젝트에 `gradlew`와 `gradlew.bat` 파일을 생성하고, `gradle/wrapper/gradle-wrapper.properties` 파일에 Gradle 버전을 기록합니다. 2. build.gradle 파일에서 Java 버전 설정 Java 버전을 설정하는 가장 일반적인 방법은 `build.gradle` 파일에서 `sourceCompatibility`와 `targetCompatibility` 속성을 사용하는 것입니다. 이 속성들은 Java 소스 코드의 호환성을 설정합니다. ```groovy plugins { id 'java' } java { sourceCompatibility = '11' targetCompatibility = '11' } ``` 위의 예제에서는 Java 11을 사용하도록 설정하고 있습니다. `sourceCompatibility`는 소스 코드가 어떤 버전의 Java로 작성되었는지를 나타내고, `targetCompatibility`는 컴파일된 코드가 어떤 버전의 Java에서 실행될 수 있는지를 나타냅니다. 3. Java 플러그인 사용 Java 플러그인을 사용하는 경우, `build.gradle` 파일에 다음과 같이 설정할 수 있습니다: ```groovy plugins { id 'java' } sourceCompatibility = '11' targetCompatibility = '11' ``` 이 방법은 Java 플러그인을 적용한 후에 직접적으로 `sourceCompatibility`와 `targetCompatibility`를 설정하는 방식입니다. 4. Gradle 7.0 이상에서의 Java 버전 설정 Gradle 7.0 이상에서는 `java` 블록 내에서 `toolchain`을 사용하여 Java 버전을 설정할 수 있습니다. 이 방법은 특정 Java 버전의 JDK를 자동으로 다운로드하고 사용할 수 있게 해줍니다. ```groovy java { toolchain { languageVersion = JavaLanguageVersion.of(11) } } ``` 이 설정은 Gradle이 JDK 11을 자동으로 다운로드하고 사용할 수 있도록 합니다. 이 방법은 여러 Java 버전을 지원하는 프로젝트에서 유용합니다. 5. 환경 변수 설정 Java 버전을 설정하는 또 다른 방법은 시스템 환경 변수를 사용하는 것입니다. `JAVA_HOME` 환경 변수를 설정하여 Gradle이 사용할 JDK를 지정할 수 있습니다. 이 방법은 Gradle이 실행되는 환경에 따라 다르게 설정할 수 있습니다. ```bash export JAVA_HOME=/path/to/your/jdk ``` 이렇게 설정한 후 Gradle을 실행하면 지정한 JDK가 사용됩니다. 6. Gradle 빌드 시 Java 버전 확인 Gradle 빌드 시 사용 중인 Java 버전을 확인하려면 다음 명령어를 사용할 수 있습니다: ```bash ./gradlew -version ``` 이 명령어는 Gradle의 버전과 함께 사용 중인 Java 버전 정보를 출력합니다. 결론 Gradle에서 Java 버전을 설정하는 방법은 다양하며, 프로젝트의 요구 사항에 따라 적절한 방법을 선택할 수 있습니다. `build.gradle` 파일에서 직접 설정하는 방법, Gradle Toolchain을 사용하는 방법, 환경 변수를 설정하는 방법 등 여러 가지 방법이 있습니다. 각 방법의 장단점을 고려하여 프로젝트에 가장 적합한 방법을 선택하는 것이 중요합니다.