개발/개발환경구성(macOS)

AI Copilot Dev#3-Java 21 (Azul Zulu) 설치(MacOS)

sftth-main 2026. 1. 1. 17:03
반응형

본 장에서는 Azul Zulu Java 21 (LTS) 환경을 구축하는 방법을 가이드 합니다. 가이드 내용은 기존 Brew OpenJDK 삭제부터 환경 변수 설정까지 단계별로 안내합니다.

1. 기존 OpenJDK 17 삭제 (Homebrew)

먼저 본 설치를 진행하는 환경에서 이전 버전의 java가 설치 되어 있었습니다. homebrew로 설치된 openjdk 17 버전인데 시스템 충돌을 방지하기 위해 Homebrew로 설치된 OpenJDK 17을 제거합니다.

  1. 터미널을 열고 아래 명령어를 입력하여 삭제합니다.
    brew uninstall openjdk@17
    
  2. (선택 사항) 남은 설정이나 불필요한 파일을 정리합니다.
    brew cleanup
    

2. Azul Zulu 21 다운로드 및 압축 해제

전달해주신 링크를 통해 파일을 다운로드하고, 지정된 경로인 ~/IDE/bin에 설치합니다.

  1. 다운로드:
    • Azul Downloads 페이지에 접속합니다.
    • Java 21 LTS / macOS / x86 64-bit / JDK / .tar.gz 항목을 찾아 다운로드합니다.
      • 예시 파일명: zulu21.46.19-ca-jdk21.0.5-macosx_x64.tar.gz (버전 번호는 시점에 따라 다를 수 있습니다.)
  2. 설치 디렉토리 준비:
    mkdir -p ~/IDE/bin
    
  3. 파일 이동 및 압축 해제: 다운로드 경로가 ~/Downloads라고 가정했을 때, 아래 명령어를 순서대로 실행합니다.
    # 다운로드 폴더의 파일을 설치 위치로 압축 해제
    tar -xvf ~/Downloads/zulu21*.tar.gz -C ~/IDE/bin
    

3. JAVA_HOME 환경 변수 영구 등록

압축이 풀린 폴더를 찾아 JAVA_HOME으로 등록합니다. macOS에서 .tar.gz로 받은 JDK는 보통 내부에 zulu-21.jdk/Contents/Home 구조를 가지거나, 폴더 자체가 Home 역할을 할 수 있습니다.

  1. 정확한 폴더명 확인: 먼저 ls 명령어로 압축 풀린 폴더의 정확한 이름을 확인합니다.가정: 확인된 폴더명이 zulu21.46.19-ca-jdk21.0.5-macosx_x64 라고 가정하고 진행합니다.
  2. ls ~/IDE/bin
    
  3. 설정 파일 열기 (.zshrc):
    nano ~/.zshrc
    
  4. 환경 변수 추가: 파일 맨 아래에 다음 내용을 추가합니다. (폴더명 부분은 위에서 확인한 실제 이름으로 변경해주세요)Tip: 정확한 경로를 모르겠다면 터미널에서 cd ~/IDE/bin/ 으로 들어가 bin 폴더가 보일 때까지 이동한 뒤 pwd를 입력해 그 경로를 복사하여 사용하세요.
  5. # Java Path Configuration (Azul Zulu 21)
    # 주의: 만약 폴더 안에 zulu-21.jdk/Contents/Home 구조가 있다면 그 경로까지 적어야 합니다.
    # 일반적인 tar.gz 구조 기준:
    export JAVA_HOME=~/IDE/bin/zulu21.46.19-ca-jdk21.0.5-macosx_x64/zulu-21.jdk/Contents/Home
    
    # 만약 위 경로가 없다면 아래와 같이 bin의 상위 폴더를 지정하세요.
    # export JAVA_HOME=~/IDE/bin/zulu21.46.19-ca-jdk21.0.5-macosx_x64
    
    export PATH=$JAVA_HOME/bin:$PATH
    
  6. 저장 및 적용:
    • Ctrl + O (저장) -> Enter
    • Ctrl + X (종료)
    • 설정 적용:
      source ~/.zshrc
      

4. 설치 검증

설정이 올바르게 되었는지 확인합니다.

  1. Java 버전 확인:성공 시 출력 예시:
    java -version
    
    openjdk version "21.0.5" 2024-10-15 LTS
    OpenJDK Runtime Environment Zulu21.46+19-CA (build 21.0.5+11-LTS)
    OpenJDK 64-Bit Server VM Zulu21.46+19-CA (build 21.0.5+11-LTS, mixed mode, sharing)
  2. JAVA_HOME 경로 확인: 아래 명령어를 실행하였을 때 설정한 경로가 그대로 출력되면 정상입니다.
    echo $JAVA_HOME
    

 

반응형