요구사항

Gradle 최신 버전(9.0.0)은 Java JDK 17 이상이 설치되어 있어야 합니다. 주요 OS에서 대부분 설치가 가능합니다. 자바 버전은 아래 명령어로 확인할 수 있습니다.

자바버전 확인

  java -version

Gradle은 Groovy Library를 포함하여 배포되기 때문에 특별히 따로 설치할 필요는 없습니다. 기존에 설치되어 있는 Groovy가 있어도 그 버전은 무시합니다.

설치파일 다운로드

다운로드 페이지에서 최신 버전인 9.0.0 버전을 다운로드 받습니다.

실행 파일만 있는 binary-onle나 각종 문서을 포함하고 있는 complete 를 받습니다.

압축 해제

C:\ 에 Gradle 디렉토리를 만들고 그 디렉토리에 다운받은 압축파일을 풀어줍니다.

C:\Gradle\gradle-9.0.0 밑에 bin, docs, init.d 등 디렉토리가 생기도록 해주세요.

환경 설정

윈도우 키 를 눌러서 검색란에 환경 변수 라고 입력하면 시스템 환경 변수 편집 화면 이 검색됩니다. 이걸 실행!

여기서 오른쪽 하단 환경 변수 클릭

시스템 변수 에 새로 만들기 클릭

변수 이름에 GRADLE_HOME

변수 값에 C:\Gradle\gradle-9.0.0

시스템 변수 중 Path 를 선택해서 편집 -> 새로 만들기 %GRADLE_HOME%\bin 추가합니다.

Gradle 버전을 업데이트 하고자 할 때는 앞선 절차대로 진행하고 시스템 변수 GRADLE_HOME 값만 새로운 버전을 받은 경로로 바꿔주시면 됩니다.

검증

명령 프롬프트를 실행해서

gradle -v

이와 같은 출력이 나오면 성공

------------------------------------------------------------
Gradle 9.0.0
------------------------------------------------------------

Build time:   2025-07-31 ...
...

환경 변수를 설정하기 전에 명령 프롬프트가 열려 있었다면, 닫고 다시 열어야 변경된 설정이 적용됩니다.