JDK + Eclipse 포터블(Portable) 개발환경 구축 방법

Windows에서 설치형이 아닌 포터블 방식으로 JDK 21과 Eclipse 2024 개발환경을 구성하는 방법을 소개합니다. 이 방법은 환경변수 설정 없이 JDK를 프로젝트별로 사용할 수 있고, USB나 네트워크 드라이브로 어디서든 개발환경을 실행할 수 있어 휴대성과 확장성이 뛰어납니다.
 
 

 JDK + Eclipse 포터블(Portable) 개발환경 구축 방법

 

목차

1. 설치개요

2. JDK21다운로드 및 설치

3. Eclipse 2024 다운로드 및 설치

4. Eclipse 실행 설정(JDK 직접 지정)

5. Eclipse 실행 테스트

6. Eclipse 환경 설정(폰트/문자셋/Gradle/Maven/Java)

추천글

 
 

1. 설치개요

• 설치는 Windows Installer를 사용하지 않고, 압축 파일을 다운로드하여 직접 설정합니다.
• 환경 변수(JAVA_HOME)를 설정하지 않고, Eclipse 실행 시 특정 JDK를 사용하도록 설정합니다.

장점:
 - 프로젝트별 JDK 버전 설정 가능
 - USB, NAS, 클라우드로 개발환경 휴대 가능
 - 사전 설정된 Eclipse+JDK를 팀원과 공유 가능

 

• JDK 경로: D:/JAVA_DEVELOPE/jdk-21
• Eclipse 경로: D:/JAVA_DEVELOPE/eclipse-2024
• 워크스페이스 경로: D:/JAVA_DEVELOPE/workspace

 
 

2. JDK 21 다운로드 및 설치

1. Adoptium 공식 사이트 접속

Home | Adoptium

2. Release  Archive → Java 21(LTS) 버전을 선택하고, Windows용 Binary 파일을 다운로드합니다.
 

 
3. 다운로드한 ZIP 파일을 D:/JAVA_DEVELOPE/ 경로에 압축 해제합니다.
4. 압축 해제된 폴더 이름을 jdk-21로 변경합니다.
5. JDK가 정상적으로 설치되었는지 확인합니다.

D:\>D:/JAVA_DEVELOPE/jdk-21/bin/java -version
openjdk version "21.0.6" 2025-01-21 LTS
OpenJDK Runtime Environment Temurin-21.0.6+7 (build 21.0.6+7-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.6+7 (build 21.0.6+7-LTS, mixed mode, sharing)

 
 

3. Eclipse 2024 다운로드 및 설치

1. Eclipse 다운로드 페이지접속

Eclipse Downloads | The Eclipse Foundation

2. Download Packages → Eclipse IDE 2024 → Windows | x86_64 를 선택하고 ZIP 압축 파일을 다운로드합니다

3. 다운로드한 ZIP 파일을 D:/JAVA_DEVELOPE/ 경로에 압축 해제합니다.
4. 압축 해제된 폴더 이름을 eclipse- 2024으로 변경합니다.
5. Eclipse 실행 파일(eclipse.exe)이 D:/JAVA_DEVELOPE/eclipse-2024/ 폴더 내에 위치하는지 확인합니다.
 

4. Eclipse 실행 설정 (JDK 직접 지정)

• 환경 변수 설정 없이 Eclipse가 특정 JDK를 사용하도록 하기 위해, eclipse.ini를 수정합니다.

• -vm 옵션과 경로는 반드시 줄을 나누어 입력하고, -vm은 -vmargs보다 위에 위치해야 합니다.

 

5. Eclipse 실행 테스트

• 프로젝트를 관리할 D:/JAVA_DEVELOPE/workspace 경로를 생성합니다.
• eclipse를 실행 후 workspace 경로를 선택합니다.

D:\JAVA_DEVELOPE\eclipse-2024\eclipse.exe

 
 

6. Eclipse 환경 설정 (폰트/문자셋/Gradle/Maven/Java)

◆ 폰트 설정

• 필요한 경우 개발언어의 가독성 향상을 위해 폰트를 선택합니다.
• Window > Preferences > General > Appearance > Colors and Fonts
• 가독성 좋은 폰트로 변경 추천 (ex. D2Coding, JetBrains Mono)

 
◆ 문자셋 설정

• Text 문서의 문자셋을 UTF-8로 설정합니다.
• Preferences > General > Workspace > Text file encoding: UTF-8
• .properties 파일: 기본 ISO-8859-1 (Spring은 동일), 필요 시 인코딩 조절

 
◆ Gradle 설정

• Gradle은 빌드 자동화 도구로, Maven과 같은 역할을 하지만 더 빠르고 유연한 방식으로 빌드를 수행할 수 있습니다
• Gradle Wrapper 방식 권장 (프로젝트 내 gradlew 사용)\

Gradle user Home :
   Gradle 라이브러리(Dependency)와 빌드 캐시 를 저장하는 경로이며,기본적으로    $HOME/.gradle (C:\Users\사용자\.gradle  위치를 사용하며 필요시 다른 위치로 설정할 수 있습니다.
Java Home :
   Gradle이 사용할 Java(JDK) 경로를 설정하는 옵션으로, JAVA_HOME 환경 변수가 설정되어 있지 않거나 여러 버전의 JDK가 있는 경우 명확하게 지정하여 사용합니다.
Automatic Project Synchronization :
   Gradle 설정이 변경될 때 자동으로 프로젝트 설정을 업데이트 합니다.

 
◆ Maven 설정

• Maven은 Java 프로젝트의 빌드 및 의존성 관리를 자동화하는 도구입니다.
• 기본적으로 XML 기반의 pom.xml(Project Object Model) 파일을 사용하여 프로젝트의 빌드, 패키징, 배포를 관리합니다.
• maven의 기본 환경 및 저장소는 C:\Users\(사용자 이름)\.m2\ 이며 필요시 다른 경로를 설정하여 사용합니다.
•  C:\Users\(사용자 이름)\.m2\settings.xml 파일이 없을 경우 아래 내용을 참고하여 생성하면 됩니다.

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
  http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <localRepository>D:/JAVA_DEVELOPE/maven-home</localRepository>
</settings>

 
◆ Java 설정

• Eclipse가 사용할 Java 런타임 환경(JRE/JDK)을 지정하는 곳으로, 앞서 설치한 JDK로 설정하여 사용하도록 하겠습니다.

 
 
 
이 글에서는 JDK 21과 Eclipse 2024를 포터블(Portable) 개발환경으로 구성하는 방법을 자세히 알아보았습니다. 환경 변수 설정 없이 JDK를 직접 지정하고, Eclipse도 설치형이 아닌 포터블로 구성하면 언제 어디서나 동일한 개발 환경을 손쉽게 재현할 수 있습니다. Java 개발환경을 손쉽게 복제하거나 공유하고 싶은 개발자에게 유용한 방법입니다.
 
 

추천글

 

• [Java] 자바 이클립스 설치와 eclipse 초기화 방법
• 이클립스(전자정부프레임) 폐쇄망 환경에서 Gradle 빌드하기