AI Copilot Dev#4-Gradle 설치(MacOS)

이번에는 AI Copilot 개발 사전 작업의 마지막으로  macOS Sequoia 15.6.1 환경에서 Gradle 9.2.1 버전을 ~/IDE/bin 경로에 수동으로 설치하는 방법을 설명합니다.

---

설치 개요

• 목적: 신규 프로젝트 개발을 위한 로컬 Gradle 환경 구성
• OS: macOS Sequoia 15.6.1
• Target Version: Gradle 9.2.1
• 설치 경로: ~/IDE/bin/

---

단계별 설치 가이드

1. 사전 준비 (Java 설치 확인)

Gradle은 JVM(Java Virtual Machine) 위에서 동작하므로 Java가 먼저 설치되어 있어야 합니다. 터미널을 열고 아래 명령어로 확인해 주세요.

java -version

Note: 만약 Java가 설치되어 있지 않거나 버전 정보가 나오지 않는다면, https://sftth.tistory.com/98를 통해 JDK(Java Development Kit)를 먼저 설치해야 합니다.

2. 설치 디렉토리 생성

요청하신 설치 위치인 ~/IDE/bin 디렉토리가 없다면 아래 명령어를 통해 디렉토리를 생성합니다.

mkdir -p ~/IDE/bin

3. Gradle 다운로드 및 압축 해제

Gradle 공식 배포판을 다운로드하고 지정된 위치에 압축을 해제합니다. (Binary-only 버전 사용)

1. 다운로드: 터미널에서 아래 명령어를 입력하여 설치 파일을 다운로드합니다.

   curl -L https://services.gradle.org/distributions/gradle-9.2.1-bin.zip -o gradle-9.2.1-bin.zip
   

2. 압축 해제: 생성해 둔 ~/IDE/bin 디렉토리에 압축을 풉니다.

   unzip gradle-9.2.1-bin.zip -d ~/IDE/bin
   

3. 파일 정리 (선택): 다운로드한 zip 파일은 더 이상 필요 없으므로 삭제합니다.

   rm gradle-9.2.1-bin.zip
   

4. 환경 변수 설정 (PATH 등록)

터미널의 어느 위치에서든 gradle 명령어를 사용할 수 있도록 PATH를 설정합니다. macOS Sequoia는 기본 쉘로 Zsh를 사용하므로 ~/.zshrc 파일을 수정합니다.

1. 설정 파일 열기:

   nano ~/.zshrc
   

2. 환경 변수 추가: 파일의 맨 아래에 다음 내용을 추가합니다.

   # Gradle Path Configuration
   export PATH=$PATH:~/IDE/bin/gradle-9.2.1/bin
   

3. 저장 및 종료:
   • Ctrl + O (저장) -> Enter
   • Ctrl + X (종료)
4. 설정 반영: 변경된 내용을 현재 터미널에 즉시 적용합니다.

   source ~/.zshrc
   

5. 설치 검증

설치가 정상적으로 완료되었는지 버전을 확인합니다.

gradle -v

정상 출력 예시: 화면에 다음과 유사한 정보가 출력되면 성공입니다.

------------------------------------------------------------
Gradle 9.2.1
------------------------------------------------------------

Build time:   ...
Kotlin:       ...
Groovy:       ...
Ant:          ...
JVM:          ... (사용 중인 Java 버전)
OS:           Mac OS X 15.6.1 x86_64 (또는 aarch64)

---

문제 해결 (Troubleshooting)

• "Permission denied" 오류 발생 시: 실행 권한이 없을 경우 아래 명령어로 권한을 부여해 주세요.

  chmod +x ~/IDE/bin/gradle-9.2.1/bin/gradle
  

• macOS 보안 경고 ("개발자를 확인할 수 없음") 발생 시: 터미널에서 다음 명령어로 격리 속성을 제거합니다.

  xattr -d com.apple.quarantine ~/IDE/bin/gradle-9.2.1/bin/gradle