✈️ Migration in jdk Amazon corretto 21

1. Amazon Corretto 21.0.3 다운로드 및 설치

(intellij 통해 다운로드를 할 시 2번부터 보시면됩니다.)

• Amazon Corretto 다운로드
  • Amazon Corretto 공식 웹사이트에서 Amazon Corretto 21.0.3을 다운로드합니다.
  • 운영체제에 맞는 설치 파일을 선택하여 다운로드합니다.

2. Amazon Corretto 설치

• 다운로드한 파일을 실행하여 설치합니다.

  • 설치 경로를 기억해둡니다.

• 저장 위치는 환경 변수를 설정 해둔 경우 해당 경로에 새로운 디렉토리로 변경하고 해당 위치에 저장합니다.

  • 새로운 디렉토리가 없다면 생성 후 해당 위치에 저장합니다

• IntelliJ를 활용 하는 경우 (21 버전 선택 후, Amazon Corretto 21.0.3 Vender 선택)

3. IntelliJ IDEA에서 Project SDK 설정

• IntelliJ IDEA 실행
  • IntelliJ IDEA를 실행하고 프로젝트를 엽니다.
• Project Structure 열기:
  • 단축키 Ctrl + Alt + Shift + S를 눌러 Project Structure 창을 엽니다.
• Project SDK 설정:
  • 좌측 메뉴에서 Project를 선택합니다.
  • Project SDK 드롭다운 메뉴에서 Add SDK를 선택한 후 JDK를 선택합니다.
  • Amazon Corretto 21.0.3이 설치된 경로를 선택하여 추가합니다.
  • Project language level이 SDK default로 설정되어 있는지 확인합니다.

4. Gradle Settings 열기

• 메뉴에서 File > Settings를 클릭합니다. (macOS의 경우 IntelliJ IDEA > Preferences)
• 좌측 메뉴에서 Build, Execution, Deployment > Build Tools > Gradle을 선택합니다.
• Gradle JVM 드롭다운 메뉴에서 Amazon Corretto 21.0.3을 선택합니다 (Project SDK를 설정 했다면 디폴트 값을 선택해도 괜찮습니다).

5. build.gradle 파일 수정

• Java Toolchain 설정 변경
  • build.gradle 파일을 열고 Java Toolchain 설정을 다음과 같이 변경합니다.

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

• (Load gradle 확인해 주세요 - 코끼리 이미지 클릭)

6. 프로젝트 빌드 및 테스트 -Gradle 클린 빌드:
   • 터미널에서 프로젝트 루트 디렉터리로 이동한 후 다음 명령을 실행합니다.

./gradlew clean build

• 프론트와 벡엔드 프로젝트 함께 있는 경우 벡엔드 프로젝트의 root 경로 (ex webtoon-search) 에 위치해야 합니다.

환경 변수가 잘 적용되었는지 확인하기 위해서 CMD (또는 Terminal) 에서 java --version, echo %JAVA_HOME% 명령어를 마이그레이션된 버전으로 출력되는지 확인해 주세요!

C:\Users\hi>java --version
openjdk 21.0.3 2024-04-16 LTS
OpenJDK Runtime Environment Corretto-21.0.3.9.1 (build 21.0.3+9-LTS)
OpenJDK 64-Bit Server VM Corretto-21.0.3.9.1 (build 21.0.3+9-LTS, mixed mode, sharing)

C:\Users\hi>echo %JAVA_HOME%
C:\Program Files\ojdkbuild\java-21-openjdk-21.0.3

C:\Users\hi>

JAR 파일을 실행하여 애플리케이션 작동 여부를 확인 하고 싶을 시, jar 파일 빌드 명령어를 통해 확인 가능합니다.

java -jar build/libs/your-application-name.jar

👀 도움이 될 수 있는 빌드 관련 명령어

• 빌드 과정 로그

./gradlew build --info

• 빌드 디버그

./gradlew build --debug

• Gradle 캐시 정리 및 의존성 새로고침

gradlew clean --refresh-dependencies

• Gradle 래퍼 버전 업데이트

.\gradlew wrapper --gradle-version 8.8

• Gradle 현재 버전 확인 & 특정 버전 업데이트 & 최신

.\gradlew --version
.\gradlew wrapper --gradle-version [version]
.\gradlew wrapper --gradle-version latest

gradle version 확인을 위한 링크