윈도우에서 Gradle은 설치

윈도우에서 Gradle은 설치 파일 없이 압축만 풀고 환경 변수만 잡아주면 됩니다. 아래 순서대로 한 번만 세팅하면 이후에는 어디서든 gradle 명령을 쓸 수 있습니다.

사전 준비 (JDK)

• Gradle은 JDK가 필요하므로 먼저 JDK 8 이상이 설치되어 있어야 합니다.

• 명령 프롬프트(cmd)나 PowerShell에서 java -version을 실행했을 때 버전 정보가 나오면 이미 설치된 것입니다.

• 설치 안 되어 있으면 Oracle JDK나 Temurin 같은 배포판을 설치한 뒤, JAVA_HOME과 PATH에 JDK를 잡아두는 것을 권장합니다.

Gradle 다운로드

• https://gradle.org/releases 페이지에 접속합니다.

• 사용하고 싶은 버전의 “binary-only” ZIP 파일을 다운로드합니다. (예: gradle-8.x-bin.zip)

압축 해제 및 폴더 구성

• C 드라이브에 C:\Gradle 또는 C:\dev\gradle 같은 전용 폴더를 하나 만듭니다.

• 다운로드한 gradle-버전-bin.zip 파일을 해당 폴더에 압축 해제합니다.

• 예: C:\Gradle\gradle-8.x\bin 형태의 경로가 생기도록 해 둡니다.

환경 변수 설정

1. 시작 메뉴에서 “시스템 환경 변수 편집” 검색 후 실행합니다.

2. “환경 변수(N)…” 버튼을 클릭합니다.

GRADLE_HOME (선택이지만 권장)

• “시스템 변수(S)”에서 “새로 만들기(N)…” 클릭

  • 변수 이름: GRADLE_HOME

  • 변수 값: C:\Gradle\gradle-8.x (본인 경로에 맞게)

Path에 bin 경로 추가

• “시스템 변수(S)” 목록에서 Path 선택 후 “편집(E)…” 클릭

• “새로 만들기(N)”를 눌러 다음 중 하나를 추가합니다.

  • C:\Gradle\gradle-8.x\bin

  • 또는 위에서 GRADLE_HOME을 만든 경우: %GRADLE_HOME%\bin

• 모든 창에서 “확인”을 눌러 빠져나옵니다.

설치 확인

• 새 명령 프롬프트(cmd) 또는 PowerShell을 엽니다. (기존 창은 닫고 새로 여는 것이 안전합니다.)

• 아래 명령을 실행합니다.

  • gradle -v

• Gradle 버전, JVM 정보 등이 출력되면 정상 설치된 것입니다.

• “gradle을(를) 인식할 수 없다” 같은 메시지가 나오면:

  • Path에 올바른 ...\bin 경로가 들어갔는지

  • 오타가 없는지

  • 새 터미널을 연 것인지
    를 다시 확인하면 됩니다.

추가 팁 (프로젝트 단위 wrapper)

• 실무에서는 각 프로젝트에 Gradle Wrapper(gradlew, gradlew.bat)를 두고 .\gradlew build처럼 사용하는 방식을 많이 씁니다.

• Wrapper가 있으면 로컬에 Gradle 시스템 설치가 없어도 해당 프로젝트에 맞는 버전을 자동으로 내려받아 사용합니다.