[Maven] Maven의 개념 / Maven 설치하고 IDE 없이 Maven 프로젝트 만들고 실행하기 / Build LifeCycle과 Phase

* Maven의 개념

 

 

Maven이란 빌드(build) 툴의 일종이다. 빌드란 소스 코드 파일을 JVM이나 WAS가 인식할 수 있는 구조로 패키징 하는 과정 및 결과를 말한다. 메이븐을 사용하면 프로젝트 생성, 라이브러리 설정, 코드 작업 등을 쉽게 할 수 있다. 이클립스와 같은 IDE에서도 프로젝트 생성 등을 할 수 있지만 IDE는 빌드 툴과는 다르다. 빌드 툴이 빌드 과정에서의 프로젝트 생성, 라이브러리 설정 등에 관여할 수 있다면 IDE는 더 다양한 범위를 포괄하는 더 큰 단위의 도구이다. IDE는 형상관리, 디버거, 컴파일러, 탐색기, 콘솔, 편집기 등의 기능을 포함한다. Maven은 특정한 IDE에 종속된 것이 아니며 이클립스, Visual Studio Code, IntellijJ 등 여러 IDE는 전부 메이븐을 이용할 수 있다.

 

 

* Maven 설치하기

 

maven.apache.org/download.cgi 에서 Binary zip archive 파일 다운로드 (apache-maven-3.6.3-bin.zip)

C:\apache-maven-3.6.3-bin\apache-maven-3.6.3\bin\mvn 실행하기 위해 환경변수를 설정한 후 콘솔창에서 실행한다. 

시스템 변수에 M2_HOME에 apache-maven-3.6.3 설정하고(bin 폴더보다 하나 상위), path에 %M2_HOME%\bin을 설정한다. 콘솔창에서 mvn -version을 입력하여 제대로 설정되었는지 확인할 수 있다.

 

 

 

* mvn -version 실행 에러

※ The JAVA_HOME environment variable is not defined correctly
This environment variable is needed to run this program
NB: JAVA_HOME should point to a JDK not a JRE

 

나의 경우 이 에러가 발생하였는데, JAVA_HOME에 jdk가 두 가지 설정되어 있어서 그런 것 같다.

 

JAVA_HOME

 

Path

이유는 정확히 모르겠지만 콘솔창에 set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_261를 입력해서 다시 환경변수를 설정하고 확인했더니 잘 되었다. 일시적인 해결법 같기는 한데 다른 걸 건드리자니 혹여나 문제가 생길까봐 일단은 이렇게 해결했다.

 

 

* IDE 없이 Maven 프로젝트 생성하기

 

 

새로 프로젝트를 만들 디렉토리로 이동한 후, 

mvn archetype:generate -DgroupId=com.newlecture -DartifactId=javaprj -DarchetypeArtifactId=maven-archetype-quickstart 입력

 

archetypeArtifactId 옵션은 다른 사람이 만든 maven-archetype-quickstart 프로젝트 구조를 기반으로 내가 메이븐 프로젝트를 생성할 수 있다는 뜻이다. 반대로 내가 만든 프로젝트 구조를 다른 사람에게 배포할 수도 있다. (=>메이븐의 특징, 장점)

 

 

 

※ 참고. 콘솔창 cd(change directory) 관련 명령어

cd.. => 폴더 한 단계 아래로 이동

 

cd 폴더명 => 원하는 상위 폴더로 이동 (ex. C드라이브 안에서 cd maven)

 

cd\ => 루트 폴더로 이동

 

d: => D드라이브로 변경 (또는 c:)

 

 

엔터쳐서 실행하면 다음과 같이 여러가지 다운로드, 입력 과정이 진행되고 성공적으로 끝났다면 연두색 BUILD SUCCESS를 확인할 수 있다.

 

생성된 프로젝트의 구조(해당 폴더 디렉토리에서 cmd 입력, tree 명령어로 볼 수 있다)

 

dir을 입력하거나 탐색기를 열어서 프로젝트가 생성되었는지 확인할 수 있다.

javaprj 밑에는 pom.xml이 생성되었으며, javaprj\src\main\java\com\newlecture 안에 App.java라는 기본 소스도 생성되었다. (Hello world!)

콘솔창에서 컴파일 등의 작업을 하기 위해서는 pom.xml이 있는 경로, 이 경우 javaprj에서 실행해야 한다.

 

App.java의 소스 코드를 수정한 후 mvn compile을 입력하면 컴파일 할 수 있다.

빌드 실패했을 경우 pom.xml에 아래 코드를 추가하고 다시 컴파일 하면 된다.

 

  <properties>
	<maven.compiler.source>1.8</maven.compiler.source>
	<maven.compiler.target>1.8</maven.compiler.target>
  </properties>

 

콘솔창에서 mvn package를 입력하면 패키징 작업을 수행하여 target 폴더 안에 jar 파일이 만들어진다.

 

 

target\classes 안의 클래스 파일로도 실행이 가능하고, jar 파일로도 실행이 가능하다.

 

1) 클래스 파일 이용하여 실행하기

 

target\classes 폴더 안에서 [패키지명.파일명]으로 실행해야 한다.

 

 

2) jar 파일 이용하여 실행하기

 

-cp으로 클래스 패스 디렉토리 지정하고 jar 파일 속 com.newlecture.App java 파일을 실행한다.

 

 

 

 

* Build LifeCycle과 Phase들

 

mvn compile, mvn test, mvn package 등의 명령어를 사용하여 컴파일, 테스트, 패키징 등을 수행할 수 있는데 이러한 것들을 단계(phase)라고 한다. compile, test, package가 수행 단계에 해당한다. 

 

Maven의 단계들

 

어떤 명령어를 실행한다면 그 앞 단계부터 전부 실행된다. 예를 들어 mvn compile을 했다면 validate, initialize 등 앞 단계들은 자동으로 수행된다.

 

이러한 단계들은 pom.xml에 정의된 <packaging>에 따라 달라질 수 있으나 (pom, jar, war 등...) 대부분 비슷한 단계로 구성된다.

 

pom(project object model) 파일은 프로젝트를 구성하고 있는 내용을 모델로 가지고 있다. pom을 변경하면 프로젝트의 설정이 달라질 수 있다.

 

메이븐은 각 단계를 플러그인 방식으로 끊어놓았다. 단계마다 단계를 실행하는 프로그램이 따로 있어서 플러그인처럼 뺐다 꽂았다 할 수 있게 되어 있다.

 

 

 

위 그림에서 파란 글씨(process-resources, compile 등) 단계는 어떠한 설정도 하지 않았어도 기본적으로 설정되는 단계이며, 각 단계에 해당하는 기본 프로그램(Plug-in)이 매핑되어 있다. 설정되지 않은 다른 단계들의 플러그인 설정은 pom.xml에서 할 수 있으며, 기본 설정된 단계도 pom.xml에서 수정할 수 있다. 플러그인을 내부적으로 구성하고 있는 프로그램이 있는데 그것을 Goal이라고 한다(연두색 글씨).

 

 

 

mvn hepl:describe -Dcmd=compile 명령어로 단계별 플러그인을 확인할 수 있다.

(메이븐에서 제공하는 다른 플러그인 참고. maven.apache.org/plugins/index.html)

 

 

메이븐만 사용해서 편집하거나 디버그 하기 어려우므로 이후에는 이클립스에서 메이븐을 얹어서 사용하도록 한다.