Eclipse에서 Maven 프로젝트 설정 및 빌드하기

환경 요구 사항

운영 체제: Windows 10/11 (64비트)
JDK 버전: 1.8 이상 (예: JDK 1.8.0_292)
Maven 버전: 3.6.x 이상
IDE: Eclipse IDE for Java Developers (Oxygen 이상)

Eclipse 환경 구성

1. JVM 실행 경로 지정

Eclipse 설치 디렉터리 내 eclipse.ini 파일을 편집하여 사용할 JDK를 명시합니다.

-startup
plugins/org.eclipse.equinox.launcher_1.4.0.v20161219-1356.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.500.v20170531-1133
-product
org.eclipse.epp.package.java.product
--launcher.defaultAction
openFile
-vm
C:\Program Files\Java\jdk1.8.0_292\bin\javaw.exe
-vmargs
-Dosgi.requiredJavaVersion=1.8
-Xms512m
-Xmx2048m

중요: -vm 옵션은 -vmargs 바로 전에 위치해야 하며, 각 옵션은 별도의 줄에 작성해야 합니다.

2. 기본 JRE 설정 변경

Eclipse 메뉴에서 Window → Preferences → Java → Installed JREs 선택
Add… 클릭 후 Standard VM 선택
JRE 홈 디렉터리에 JDK 설치 경로 입력 (예: C:\Program Files\Java\jdk1.8.0_292)
생성된 항목을 체크하여 기본 JRE로 설정
옵션으로 Execution Environments 에서 JavaSE-1.8에 방금 추가한 JRE를 매핑

3. 사용자 정의 Maven 설치 적용

Preferences → Maven → Installations 이동
Add… 클릭 후 외부 Maven 설치 디렉터리 선택 (예: D:\tools\apache-maven-3.6.3)
기본 Maven으로 새로 추가한 인스턴스 선택
User Settings 탭에서 settings.xml 파일 경로 지정

4. 로컬 저장소 위치 설정

Maven의 로컬 저장소를 기본값(.m2/repository) 외의 위치로 변경하려면 settings.xml에 다음 내용 추가:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0">
  <localRepository>D:/maven-repo</localRepository>
</settings>

변경 후 Eclipse에서 Maven → User Settings에서 반영 여부 확인 가능

Maven 프로젝트 생성

File → New → Other → Maven → Maven Project
"Create a simple project" 체크 해제 후 Next
아키타입 목록에서 maven-archetype-quickstart 선택
다음 정보 입력:
- Group ID: 조직 도메인 역순 (예: com.example.project)
- Artifact ID: 프로젝트 이름 (예: my-app)
- Version: 초기 버전 (예: 1.0.0)
- Package: 기본 패키지 이름 (선택 사항)
완료 후 프로젝트 생성됨

pom.xml 구성 예시

자동 생성된 pom.xml을 아래와 같이 수정할 수 있습니다:

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
                             http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.example.myapp</groupId>
  <artifactId>my-application</artifactId>
  <version>1.0.0</version>
  <packaging>jar</packaging>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.13.2</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

빌드 및 패키징 작업 수행

컴파일 (Compile)

프로젝트 내 pom.xml 우클릭
Run As → Maven build…
Goal 입력창에 compile 또는 clean compile 입력
실행 결과 예시:

[INFO] Scanning for projects...
[INFO] 
[INFO] ----------------------< com.example:my-application >-----------------------
[INFO] Building my-application 1.0.0
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- maven-compiler-plugin:3.8.1:compile (default-compile) @ my-application ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 1 source file to /workspace/my-application/target/classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

테스트 및 설치 (Install)

Run As → Maven install 선택 시 다음 단계가 순차적으로 실행됩니다:

컴파일 (compile)
테스트 소스 컴파일 (testCompile)
단위 테스트 실행 (surefire:test)
JAR 파일 생성 (jar:jar)
로컬 저장소에 설치 (install:install)

로컬 저장소 확인

설치 후 지정한 로컬 저장소 경로 (예: D:/maven-repo)에 다음과 같은 구조로 아티팩트가 저장됩니다:

D:/maven-repo/com/example/myapp/my-application/1.0.0/
├── my-application-1.0.0.jar
├── my-application-1.0.0.pom
└── maven-metadata-local.xml

이 아티팩트는 동일 머신의 다른 Maven 프로젝트에서 의존성으로 참조할 수 있습니다.

태그: maven Eclipse JDK Maven-install Java-build

8월 1일 21:29에 게시됨

괴물 클럽