스프링 개발환경 구성하기 (4) 메이븐 설치(Maven) 및 환경변수 설정

최근글 보기 : 스프링부트 개발환경 구성하기 (4) 메이븐 Local Repository 설정

 

지금부터 Java 11, Eclipse, Tomcat 9, Maven을 순서대로 설치할 것이다. 아래 사진처럼 모두 C:\dev 폴더 안에 설치해서 관리하기 편하게 만드려고 한다.

앞으로 진행할 포스팅 순서는 아래와 같다.

• JDK 11 설치 
• 이클립스 설치
• 톰캣 9 설치 
• 메이븐 설치 (현재 포스팅)

Maven 설치

Maven 홈페이지에 접속한 후 Files 란의 최신 버전을 바로 다운받아도 되고, 이전 버전을 사용하려면 maven archive에서 원하는 버전을 다운받을 수 있다. 2022년 1월 기준으로 3.8.4 버전까지 나왔지만 (최신 버전을 받으면 진행하다 막힐 가능성이 높아서) 나는 3.8.1 버전을 다운받으려고 한다.

원하는 버전을 클릭후 'binaries/ 폴더를 누른다.

여러 파일 중에서 zip 파일인 'apache-maven-3.8.1-bin.zip'을 다운받은 후 C:\dev에서 압축 해제한다. 

Maven 설치 후 기본 설정

1) 환경변수 설정

압축을 다 풀었으면 이제 환경변수를 설정해야 한다. '윈도우키+R'을 눌러서 나타난 실행창에 sysdm.cpl 을 입력하면 아래 창이 뜬다. 고급 탭에서 '환경변수'를 클릭한다.

아래와 같이 'Path'를 선택한 후 '편집' 버튼을 클릭한다. Path 변수는 운영체제가 파일의 디렉터리를 파악하는 데 사용하는 경로이다. Path 변수에 디렉터리를 등록하면, 해당 디렉터리에 포함된 파일을 파일 경로 없이 파일 이름만으로도 사용할 수 있게 된다.

Maven이 설치된 경로를 Path에 추가하기 위해 '새로 만들기'를 클릭하여 C:\dev\apache-maven-3.8.1\bin 를 입력하고 'Enter' 키를 누른다. Path 변수에 주소가 추가된 것을 확인하고 '확인' 버튼을 누른다.

이제 Path 변수에 제대로 등록되었는지 확인하자. '윈도우키+R'을 눌러서 나타난 실행창에 'cmd'를 입력해서 콘솔 창을 띄운다. 콘솔 창에 'mvn -version'라고 입력해서 아래와 같은 화면이 나타나면 설정이 잘 끝난 것이다. 만약 'mvn'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다. 라는 문구가 뜬다면 Path 설정이 잘못된 것이다.

2) Maven Repository 변경하기

기본 Maven Repository는 C:\Users\사용자\.m2라는 폴더에서 관리한다. 나는 이것도 dev 폴더에서 관리하도록 메이븐 저장소를 로컬 저장소로 바꿀것이다. dev 폴더에서 관리하길 원하지 않는다면 이 단계는 넘어가도 된다.

1. C:\dev\apache-maven-3.8.1 에서 repository 폴더를 생성한다.
2. C:\dev\apache-maven-3.8.1\conf 에서 settings.xml 파일을 연다. 
3. setting.xml 파일에서 <localRepository> 주석 처리된 부분을 찾은 뒤, 바로 그 위에다 로컬 저장소를 등록한다.

<localRepository>C:\dev\apache-maven-3.8.1\repository</localRepository>

이제 로컬로 바꾼 Maven Repository를 이클립스에서 설정하자. 이클립스에서 [Window] - [Preference] - [Maven] - [User Settings] 으로 가서 User Settings 부분에 C:\dev\apache-maven-3.8.1\conf\settings.xml 을 등록한다. 그러면 아래의 Local Repository 란도 자동으로 변경된다.

3) Maven Integration 설치하기

맨 처음에 설치한 Maven은 실제 Maven 소스 및 실행파일이고, 앞으로 설치할 Maven Integration은 이클립스에서 Maven을 사용하기 위한 플러그인이다.

이클립스에서 메이븐을 사용하려면 'M2E' 라는 Maven Intergration을 설치해야 한다. 이클립스의 [Help] - [Install New Software]에 들어가면 창이 뜬다. Work With 란에 https://download.eclipse.org/technology/m2e/releases/latest/ 를 입력 후 엔터를 치면 관련된 소프트웨어가 나오는데 모두 설치하면 된다. 자세한 내용은 Eclipse m2e project를 참고하자. 

여기까지 하면 Maven에 대한 설정이 끝이 났다.