[웹 서비스 개발 환경 구축 ③] Maven 설치 및 이클립스와 연동하기

아파치 메이븐 Apache Maven

 

 

 

Maven은 아파치에서 개발한 프로젝트 중 하나로, 소프트웨어 프로젝트 관리 및 이해도구다.

POM(Project Object Model)에 기초하여 프로젝트의 빌드나 문서관리가 가능하다.

 

이는 개발자의 적은 노력만으로도 프로젝트에 대한 전반적인 이해를 돕는데 목적이 있다.

보다 자세한 특징은 공식 홈페이지를 참고하자.

 

 

 

---

~ 광고 타임 ~

---

 

 

 

다운로드

 

 

(이미지 캡쳐 : 아파치 메이븐 공식 홈페이지)

 

공식 홈페이지의 다운로드 페이지로 이동하여 apache-maven-3.3.9-bin.zip 항목을 받으면 된다.

다운 받은 압축파일은 적당한 위치에 압축을 풀어두고, 경로를 기억하자.

 

 

 

환경변수 설정

 

 

Maven을 이용하기 위해서는 환경 변수설정을 해줘야 한다.

 

내컴퓨터 - 우클릭 - 속성 또는 제어판 - 시스템 및 보안 - 시스템 항목으로 이동 한 후,

위 이미지와 같이 고급 시스템 설정 - 고급 탭 - 환경 변수를 선택하자.

 

 

 

---

~ 광고 타임 ~

---

 

 

 

시스템 변수의 새로 만들기를 클릭하여 MAVEN_HOME 변수를 만들자.

변수 값은 자신이 앞서 압축풀었던 경로를 설정하면 된다.

 

변수 이름 : MAVEN_HOME 변수 값 : D:\apache-maven-3.3.9(압축해제경로) 

 

 

 

 

이번에는 변수값 Path 항목(또는 대문자 PATH)을 찾아 편집버튼을 누르자.

변수 값 끝에 다음과 같이 입력하자.

변수 값 : %MAVEN_HOME%\bin; 

만약 세미콜론(;)이 기존의 변수 값 끝에 없다면 앞에 붙여줘야 한다.

세미콜론은 각 경로의 구분자 역할을 한다.

 

 

 

확인

 

환경 변수가 잘 설정되었는지 확인해보도록 하자.

 

 

 

시작 - 보조프로그램 - 실행 또는 윈도우키 + R을 눌러 실행창을 띄우고 cmd를 실행하자.

 

 

 

 

 

 

콘솔창에 mvn -version를 입력하면 위와 같이 아파치 메이븐의 버전정보를 볼 수 있다.

이는 정상적으로 환경설정이 이루어졌다는 의미가 된다.

 

 

 

 

 

이클립스 연동하기

 

 

 

우선 http://www.eclipse.org/m2e/ 로 이동하여 하단의 빨간 네모로 표시한 주소를 복사한다.

주소가 변경될 수 있기 때문에 사이트에서 직접 해당 주소를 확인하길 바란다.

 

 

 

---

~ 광고 타임 ~

---

 

 

 

 

 

주소를 복사했다면, 이클립스를 실행하여 Help - Install New Software 항목을 클릭하자.

 

 

 

 

 

 

앞서 복사했던 주소를 입력하고 엔터키를 누르면 위와 같은 항목이 나타난다.

모두 선택 후 Next를 클릭하여 설치를 진행하자.

 

파란색으로 네모친 Contact all update sites during install to find required software 항목은,

알아서 요구되는 소프트웨어들을 찾아 인스톨하겠다는 옵션이다.

이 옵션은 간혹 에러를 불러 일으킨다. 체크 여부는 개인 판단에 맡기겠다.

 

 

 

 

설치 준비가 완료되면 위와 같이 동의를 구한다.

Finish를 눌러서 설치를 진행하고, 완료되면 이클립스를 재시작 하자.

 

루나버전 사용자의 경우 마스로 업그레이드 될 수 있다.

 

 

---

~ 광고 타임 ~

---

 

 

 

설치 중 에러가 발생하는 경우

 

 

위와 같은 메시지가 나타날 수도 있다.

이는 업데이트 과정에서 참조하는 사이트가 원인이 된다.

 

에러없이 잘 마무리 되었다면 아래를 생략하고 다음을 진행하자.

 

 

첫번째 방법

 

 

이클립스 Help - Install New Software 항목을 실행하면 위와 같다.

빨간 네모로 표시한 Available Software Sites 항목을 선택하자.

 

 

 

 

모든 항목을 선택(Ctrl + A)하여 Export 버튼을 눌러서 xml 파일로 내보내자.

 

 

 

 

 

이를 Sublime text 편집기로 열면 위와 같이 나타난다.

다른 편집기로 열어도 무방하나, 노가다가 필요하기에 Sublime text 도구를 추천한다.

 

이는 앞서 Sublime text2에 대해 포스팅한 바 있으니 설치방법은 링크를 참고하자.

 

 

 

---

~ 광고 타임 ~

---

 

 

 

 

우리가 해야할 작업은, 모든 url 끝에 '/' 문자가 없는 경우 '/' 문자를 하나 추가하는 것이다.

 

1) sublime text2에서 Ctrl + F를 입력한다.

2) " selected 라고 공백을 포함하여 입력한다.

3) Alt + Enter를 누르면 모든 일치 문자에 대해 블록지정된다.

4) ← 방향키로 한 칸 앞으로 커서를 옴긴다.

5) /를 입력하면 커서 위치에 문자가 삽입된다.

6) 이번에는 Ctrl + F를 눌러 //"를 입력한다.

7) Alt + Enter를 누른 후 /"라고 입력하여 저장한다.

 

 

 

 

 

다시 이클립스로 돌아와서 항목들을 모두 지운 뒤,

Import를 선택하여 불러오고 OK를 누르고 다시 설치하면 에러없이 완료될 것이다.

 

 

 

두번째 방법

 

 

Help - Install new software 항목에서 Availale Software Sites로 다시 이동하자.

그 중 Spring 항목들을 Disable로 지정하면 업데이트 에러를 방지할 수 있다.

 

 

 

 

---

~ 광고 타임 ~

---

 

 

 

설정

 

 

 

설치가 완료되었다면, 이제 라이브러리가 생성될 repository 위치를 설정해줘야 한다.

원하는 위치에 폴더를 하나 만들면 되는데, 필자는 Maven을 압축 풀었던 폴더에 repo라는 폴더를 생성했다.

 

 

 

 

 

폴더를 하나 만들었다면, 앞서 maven을 압축풀었던 경로로 이동하여 conf 폴더에 들어가자.

setting.xml 파일이 보일 텐데, 메모장이나 Sublime Text와 같은 텍스트 편집기로 열자.

 

그리고 Ctrl + F를 눌러서 localrepository를 검색하면, 위와 같이 주석처리(<!-- -->)된 부분이 존재할 것이다.

이곳에 앞서 생성했던 폴더 경로를 지정해주면 된다.

 

<localrepository>D:\apache-maven-3.3.9/repo(폴더 경로)</localrepository> 

 

 

 

 

다시 이클립스로 돌아와서, Window - Preferences를 선택하자.

 

좌측 네비게이션에서 Maven - User Settings를 찾아 선택한 뒤,

User Settings 항목의 Browse... 버튼을 눌러 maven 폴더 - conf - settings.xml을 선택해주자.

 

다했다면, OK를 눌러 창을 닫으면 된다.

 

 

 

 

 

마치며

 

이로써 웹 서비스 개발 환경 구축이 모두 완료되었다.

실행 예제는 에러때문에 고생한 터라 쓸 기운이 없어서 다음 포스팅 때 다루겠다.

 

 

 

---

~ 광고 타임 ~

---

 

 

관련 포스팅

 

[통합 개발 환경] 자바(java) :: 이클립스 및 JDK 설치하기

 

[웹 서비스 개발 환경 구축 ①] 이클립스 :: 스프링 프레임워크 설치하기

[웹 서비스 개발 환경 구축 ②] 아파치 톰캣 설치하기

 

 

 

 

 

참고자료

 

위키 / 공식 홈페이지 / Stackoverflow

 

 

 

끝.