최신 JDK LTS 버전 설치 (버전 업그레이드) + Gradle 버전 업그레이드

작성일 : 2024-12-12
버전 : JDK 1.8.0_431 ⇒ JDK 21

---

업데이트 이유

JDK 8은 이전에 Android 개발에 널리 사용되었으나,
최신 Gradle 및 Android 빌드 도구는 더 높은 버전을 요구합니다.

Flutter 프로젝트에서 JDK 8을 사용할 경우 빌드 실패가 발생할 가능성이 높습니다.

• 최신 Gradle 버전(예: Gradle 7.x 이상)은 JDK 11 이상을 요구합니다.
• Flutter 자체는 JDK 버전에 크게 의존하지 않지만, Android 플랫폼에서 Gradle과 Android 빌드 도구를 통해 동작하기 때문에 JDK 11 이상을 사용하는 것이 권장됩니다.

---

최신 JDK 설치

---

<jdk 검색>

---

오늘 날짜 (2024-12-12) 기준으로 JDK 23 이 가장 최신 버전으로 확인됩니다.

JDK 23 과 Flutter 의 호환은 어떨까요 ?

• Flutter와 JDK 23은 이론적으로 호환될 가능성이 높습니다.
• 공식적으로 Flutter는 JDK 11 이상을 권장합니다.
• 다만, JDK 23은 Oracle의 최신 LTS(Long-Term Support) 버전이 아닙니다.
• 따라서, 일부 Gradle 플러그인 또는 Android 빌드 도구와의 호환성 문제가 발생할 가능성이 있습니다.
• 일부 오래된 Gradle 플러그인은 최신 JDK에서 작동하지 않을 수 있습니다.

그럼 JDK 권장 버전은 ?

• Flutter 프로젝트에서는 안정성과 호환성을 위해 JDK 11 또는 JDK 17(LTS)을 사용하는 것이 가장 안전합니다.

JDK LTS 최신 버전은 ?

• JDK 21 은 최신 장기 지원(LTS) 버전입니다.
• Gradle 8.5부터 JDK 21을 완전히 지원합니다. 따라서, JDK 21을 사용하려면 Gradle 버전을 8.5 이상으로 업그레이드 해야 합니다.
• Gradle 최신 버전과 JDK 21 호환성에 대한 공식 정보는 https://docs.gradle.org/current/userguide/compatibility.html 에서 확인하실 수 있습니다.

---

<Gradle Compatibility Matrix>

---

<현재 gradle 버전 확인하기>

---

웁스. 권장 버전보다 낮네요.
JDK 21 설치 후에 Gradle 버전도 업데이트 해야겠습니다.

---

<JDK 21 다운로드 페이지>

---

x64 Compressed Archive : JDK를 압축 파일 형태로 제공하는 방식, 압축 해제 후 환경 변수(JAVA_HOME, Path)를 설정하여 사용합니다.


x64 Installer와 x64 MSI Installer는 모두 설치형입니다.
용도에 맞게 하나만 선택하여 설치하시면 됩니다.

• x64 Installer (EXE 파일): 일반 사용자에게 적합한 설치 프로그램으로, 설치 과정에서 사용자 정의가 가능하며, Windows Installer가 필요하지 않습니다.
• x64 MSI Installer (MSI 파일): 대규모 배포나 IT 관리자를 위한 설치 프로그램으로, 표준화된 설치를 지원하며, Windows Installer를 통해 설치됩니다.

이 글에선 x64 Installer (EXE 파일) 설치를 진행합니다.

---

<x64 Installer (EXE 파일) 설치 진행 화면>

---

<환경변수 설정 띄우기>

왼쪽 메뉴는 윈도우키 + x 로 열 수 있습니다.

---

<환경변수 설정>

JAVA_HOME 의 기존 변수 값을 신규 JDK 21의 폴더 경로로 설정합니다.

---

<Path 경로에 %JAVA_HOME%\bin 이 설정되어 있는지 확인>

---

<JDK 버전 변경 확인>

VSCode 터미널에서 바로 확인되지 않는다면 VSCode 를 재실행 합니다.

최신 JDK LTS 버전 설치 (버전 업그레이드) + Gradle 버전 업그레이드

<JDK 업그레이드 이미지>

JDK 업그레이드 하는 스테디빌더

Gradle 버전 업그레이드

---

Gradle 버전 업그레이드

JDK 버전에 따라 권장 Gradle 버전을 업그레이드 합니다.
여러가지 방법이 있겠지만 이 글에서는 Gradle Wrapper 업그레이드를 진행합니다.

Gradle Wrapper란?

프로젝트 별로 사용하는 Gradle 버전을 관리하며, 프로젝트마다 다른 버전을 사용할 수 있습니다.

Gradle Wrapper 업그레이드 명령 실행

프로젝트 디렉토리에서 다음 명령을 실행합니다.

./gradlew wrapper --gradle-version <new-version> --distribution-type all

• <new-version>: 업그레이드할 Gradle 버전, 이 글에서는 8.5가 되겠네요.
• -distribution-type all: 바이너리와 함께 모든 관련 파일 다운로드.

---

<정상 설치 완료>

---

gradle-wrapper.properties 확인

업그레이드 후 gradle/wrapper/gradle-wrapper.properties 파일에 새 버전이 반영되었는지 확인합니다.

distributionUrl=https\\://services.gradle.org/distributions/gradle-8.5-all.zip

---

<gradle-wrapper.properties 파일 확인>

---

새 버전 확인

./gradlew --version

---

<Gradle 버전 확인>

---

<빌드 확인>

---

고생하셨습니다.
 
끝 !