Gradle 도큐먼트: macOS에서 Gradle 설치하기

참고 문서

• Gradle document: Installation

이 문서의 내용

Gradle은 Windows, Linux 그리고 macOS에서 모두 설치하여 사용 할 수 있습니다.

수동으로 설치하거나 SDKMAN! 또는 HomeBrew와 같은 패키지 관리자를 사용 할 수도 있습니다.

Gradle Wrapper를 사용하여 기존 Gradle 버전을 업그레이드 할 수 있습니다.

릴리즈 버전과 관련해서는 releases page를 참고합니다.

Prerequisites

Gradle은 JDK(Java Development Kit) 버전 8 또는 그 이상 버전이 설치되어 있어야 합니다. Gradle 버전 별 호환 JDK는 compatibility matrix를 참고합니다.

PC에 설치된 자바 버전을 확인하려면 콘솔에서 java -version을 입력합니다.

$ java -version
openjdk version "11.0.18" 2023-01-17
OpenJDK Runtime Environment Homebrew (build 11.0.18+0)
OpenJDK 64-Bit Server VM Homebrew (build 11.0.18+0, mixed mode)

Gradle은 Path에 등록된 JDK 또는 IDE에서 사용하는 JDK 또는 프로젝트에서 사용하는 JDK를 사용합니다.

$ echo $PATH
/opt/homebrew/opt/openjdk@17/bin

특정 JDK 버전이 설치된 디렉토리를 지정하려면 JAVA_HOME 환경 변수를 설정합니다.

$ echo %JAVA_HOME%
C:\Program Files\Java\jdk1.7.0_80

Gradle은 Kotlin과 Groovy를 주요 빌드 언어로 지원합니다.

Gradle에는 자체 Kotlin과 Groovy를 라이브러리를 갖추고 있기 때문에 별도 설치 할 필요는 없습니다.

만약 PC에 별도로 설치된 다른 버전의 Kotlin 또는 Groovy가 존재하더라도 Gradle은 자체 설치된 라이브러리를 사용합니다.

Java, Groovy, Kotlin 및 Android의 전체 호환성은 compatibility matrix를 참고합니다.

Windows 또는 Linux OS에서 설치

Windows에서 Gradle 설치 방법은 다음 도큐먼트를 따라서 진행합니다.

• Installing manually

Linux에서 Gradle 설치 방법은 다음 도큐먼트를 따라서 진행합니다.

• Installing with a package manager
• Installing manually

macOS에서 설치

SDKMAN! 패키지 관리자를 사용하여 설치합니다. 콘솔에서 sdk install gradle을 입력합니다.

$ sdk install gradle

SDKMAN!은 대부분의 Unix 계열 OS(macOS, Linux, Cygwin, Solaris 및 FreeBSD 등)에서 사용 가능한 여러 버전의 소프트웨어 개발 키트를 관리 및 배포하는 패키지 관리자입니다.

Gradle은 SDKMAN!에서 배포 및 유지 관리되므로 SDKMAN!으로 설치하는 것을 권장합니다.

Homebrew 패키지 관리자를 사용하여 설치하려면 콘솔에서 brew install gradle를 입력합니다.

$ brew install gradle

MacPorts 패키지 관리자를 사용하여 설치하려면 콘솔에서 sudo port install gradle를 입력합니다.

$ sudo port install gradle

다른 패키지 관리자도 사용 할 수 있지만, Gradle에서 정식으로 배포하는 것은 아니므로 가급적 상기 패키지 관리자를 사용하도록 합니다.

Gradle 설치 파일(ZIP)을 사용하여 직접 설치하려는 경우 Installing manually를 참고합니다.

설치 확인

Gradle 설치 확인을 위해서 콘솔을 열어 gradle -v을 입력합니다.

$ gradle -v

------------------------------------------------------------
Gradle 8.4
------------------------------------------------------------

Build time:   2023-03-03 16:41:37 UTC
Revision:     7d6581558e226a580d91d399f7dfb9e3095c2b1d

Kotlin:       1.8.10
Groovy:       3.0.13
Ant:          Apache Ant(TM) version 1.10.11 compiled on July 10 2021
JVM:          17.0.6 (Homebrew 17.0.6+0)
OS:           Mac OS X 13.2.1 aarch64

Gradle이 설치되어 있다면 설치 버전과 필수 언어 버전 등을 표시합니다.

정리 및 복습

• Gradle은 Windows와 macOS, Linux와 같은 Unix 계열 OS에서 설치 할 수 있습니다.
• 설치를 위해서는 최소 JDK 버전 8 이상을 필요로 합니다.
• Kotlin과 Groovy는 별도 설치할 필요가 없으며, 이미 PC에 설치된 버전이 있다고 하더라도 Gradle에 내장된 버전을 사용합니다.
• SDKMAN!과 Homebrew, MacPorts와 같은 패키지 관리자를 사용하여 설치하며 그 외 패키지 관리자는 Gradle에 의해서 정식 배포된 것은 아닙니다.
• 가급적 Gradle에서 정식 배포하는 채널인 SDKMAN!을 이용합니다.