윈도우에 Apache Maven을 설치하는 방법

 

1단계: Java Development Kit (JDK) 설치 확인

Maven은 Java 기반으로 실행되기 때문에 JDK가 먼저 설치되어 있어야 합니다. 이미 JDK가 설치되어 있는지 확인해 보세요.

• 확인 방법: cmd 또는 PowerShell을 열고 다음 명령어를 입력한 후 Enter 키를 누릅니다.

  java -version
  

• 만약 JDK가 설치되어 있다면 버전 정보가 출력될 것입니다. 만약 "java" 명령어를 찾을 수 없다는 메시지가 나온다면 JDK를 먼저 설치해야 합니다.

2단계: JDK 설치 (필요한 경우)

JDK가 설치되어 있지 않다면 다음 단계를 따라 설치하세요.

• Oracle OpenJDK 다운로드: https://jdk.java.net/ 또는 https://www.oracle.com/java/technologies/javase-downloads.html 에서 원하시는 버전의 JDK를 다운로드합니다. (일반적으로 최신 LTS 버전을 추천합니다.)
• 설치: 다운로드한 실행 파일을 실행하여 안내에 따라 JDK를 설치합니다. 설치 경로는 나중에 환경 변수 설정 시 필요하니 기억해 두세요.

3단계: Apache Maven 다운로드

이제 Apache Maven을 다운로드합니다.

• Maven 공식 웹사이트 접속: https://maven.apache.org/download.cgi 로 접속합니다.
• 다운로드 링크 클릭: "Binary zip archive" 항목 아래에 있는 .zip 파일을 클릭하여 다운로드합니다. (예: apache-maven-3.x.x-bin.zip)

4단계: Maven 압축 해제

다운로드한 Maven 압축 파일(.zip)을 원하시는 폴더에 압축 해제합니다. 일반적으로 C:\Program Files\Apache\maven 또는 C:\apache-maven과 같은 경로를 많이 사용합니다. 압축을 푼 폴더 안에 bin 폴더가 있는지 확인해 주세요.

5단계: 환경 변수 설정

Maven을 시스템 어디에서든 실행할 수 있도록 환경 변수를 설정해야 합니다.

• "고급 시스템 설정" 열기:
  • Windows 검색창에 "환경 변수"를 입력하고 "시스템 환경 변수 편집"을 클릭합니다.
  • 또는 "제어판" -> "시스템 및 보안" -> "시스템" -> "고급 시스템 설정"을 클릭합니다.
• "환경 변수" 버튼 클릭: 시스템 속성 창에서 "환경 변수" 버튼을 클릭합니다.
• "시스템 변수" 편집:
  • M2_HOME 변수 추가: "새로 만들기" 버튼을 클릭하고 다음과 같이 입력합니다.
    • 변수 이름: M2_HOME
    • 변수 값: Maven을 압축 해제한 폴더 경로 (예: C:\apache-maven-3.9.6)
  • JAVA_HOME 변수 확인 또는 추가: JDK를 설치한 경로를 가리키는 JAVA_HOME 변수가 있는지 확인합니다. 없다면 "새로 만들기" 버튼을 클릭하고 다음과 같이 입력합니다.
    • 변수 이름: JAVA_HOME
    • 변수 값: JDK 설치 경로 (예: C:\Program Files\Java\jdk-17)
  • Path 변수 편집: "시스템 변수" 목록에서 Path 변수를 찾아 선택하고 "편집" 버튼을 클릭합니다.
    • "새로 만들기" 버튼을 클릭하고 다음 경로를 추가합니다.
      • %M2_HOME%\bin
      • %JAVA_HOME%\bin (이미 없다면 추가)
    • "확인" 버튼을 클릭하여 모든 창을 닫습니다.

6단계: Maven 설치 확인

환경 변수 설정이 완료되었으면 Maven이 정상적으로 설치되었는지 확인해 봅니다.

• cmd 또는 PowerShell 다시 열기: 기존에 열려 있던 명령 프롬프트 창은 환경 변수 변경 사항을 인식하지 못하므로 새로운 창을 열어야 합니다.
• 명령어 실행: 다음 명령어를 입력하고 Enter 키를 누릅니다.

  mvn -version
  

• Maven 버전 정보, Java 버전 정보 등이 출력되면 Maven 설치가 성공적으로 완료된 것입니다