command line을 활용한 JAR 파일 생성하기

Java 개발에서 JAR(Java Archive) 파일은 Java 클래스 파일과 관련 메타데이터를 하나의 파일로 묶어 배포할 수 있게 해주는 필수적인 요소다. 현대의 IDE나 Maven, Gradle 같은 빌드 도구들이 JAR 생성을 자동화해 주지만, JAR 생성 수동 프로세스를 이해하는 것은 Java의 패키징 시스템을 이해하기 위해 중요하다.

 

JDK(Java Development Kit) 설치 필요

JDK - 컴파일을 위한 javac와 jar 파일 생성을 위한 jar 같은 필수 도구들이 포함되어 있다.

 

JAR 파일은 자바 런타임이 효율적으로 애플리케이션을 배포(deploy)할 수 있는 수단으로 설계되었다. 자바 애플리케이션을 구성하는 클래스와 관련 리소스들을 단일 파일로 묶어 압축된 형태인 JAR 파일은 한 차례의 요청으로 애플리케이션 전체를 다운로드할 수 있게 해준다.

 

1. Java 소스 코드 작성

public class MyJavaFile {
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
}

 

2. 소스 코드 컴파일

Java 소스 코드를 JVM(Java Virtual Machine)이 실행할 수 있는 바이트코드로 컴파일해야 한다.

javac MyJavaFile.java

이 명령어는 컴파일된 바이트코드가 포함된 MyJavaFile.class 파일을 생성한다.

만약 소스 코드에 문법 오류 등의 문제가 있다면 컴파일러가 해당 단계에서 이를 알린다.

 

3. Manifest 파일 생성

Manifest 파일은 JAR의 메타데이터를 포함하는 특별한 파일로 실행할 메인 클래스와 버전 정보 같은 중요한 정보를 제공한다.

1. META-INF 디렉토리 생성: mkdir META-INF
2. META-INF 디렉토리 안에 MANIFEST.MF 파일을 아래와 같이 생성:

Manifest-Version: 1.0
Main-Class: MyJavaFile
Built-By: 작성자이름

 

Manifest 파일 작성 시 주의사항:

• 파일 끝은 반드시 새 줄(newline)
• Main-Class 속성은 main 메서드가 있는 클래스를 지정
• Manifest 형식은 콜론(:)으로 구분된 키 : 값 쌍

4. JAR 파일 생성하기

jar 명령어를 사용하여 모두 패키징

jar cmvf META-INF/MANIFEST.MF myJarFile.jar MyJavaFile.class

 

명령어 옵션 설명:

• c: 새 아카이브 생성
• m: 기존 파일의 manifest 정보 포함
• v: 상세 출력 생성(압축률, 생성일시 등)
• f: 아카이브 파일명 지정

출력 결과 예

added manifest
adding: MyJavaFile.class(in = 426) (out= 289)(deflated 32%)

5. JAR 파일 테스트하기

JAR 파일 실행

java -jar myJarFile.jar

 

실행 결과

Hello World!

 

자주 발생하는 문제와 해결 방법

1. Manifest 파일 포맷 관련
   • Manifest 파일 끝에 새 줄이 있는지 확인
   • 키-값 쌍의 콜론 뒤에 공백이 없는지 확인
   • Main-Class를 올바른 클래스 이름으로 지정했는지 확인
2. 클래스를 찾을 수 없는 오류
   • 필요한 모든 클래스 파일이 JAR에 포함되어 있는지 확인
   • 패키지 구조가 manifest의 Main-Class 선언과 일치하는지 확인
   • 외부 의존성을 사용하는 경우 클래스패스가 올바르게 설정되어 있는지 확인
3. 권한 관련 문제
   • 대상 디렉토리에 쓰기 권한이 있는지 확인
   • 생성된 JAR 파일에 실행 권한이 있는지 확인

고급 JAR 기능

1) 여러 파일 추가하기

여러 클래스 파일이나 리소스를 포함시키기

jar cmvf META-INF/MANIFEST.MF myJarFile.jar *.class resources/

c(Create) : 새로운 jar 파일생성

m : 지정된 manifest 파일로부터 manifest 정보를 jar 파일 내 포함시켜 줌

v : 압축률 및 생성일시 등의 정보 제공

f : jar 파일의 이름을 지정할 경우 사용

 

2) JAR 내용 보기

JAR 파일 내용 나열하기

jar tf myJarFile.jar

t(table) : jar 파일의 목록을 나열

f : jar 파일의 이름을 지정할 경우 사용

 

3) JAR 내용 추출하기

jar xf myJarFile.jar

x(eXtract) : jar파일에서 파일 추출

f : jar 파일의 이름을 지정할 경우 사용

 

 

결론

현대의 빌드 도구들이 JAR 생성을 자동화해 주지만, JAR 파일 생성과정의 이해는 아래와 같은 상황에 필요하다.

• 패키징 문제 디버깅
• 커스텀 빌드 프로세스 생성
• 빌드 도구의 동작 원리 이해
• 빌드 도구를 사용할 수 없는 환경에서의 작업

 

 

참고 자료 :

https://engineering.tomtom.com/create-java-jar/

Back to Basics: How to create a java JAR using command line

https://ko.wikipedia.org/wiki/JAR_(%ED%8C%8C%EC%9D%BC_%ED%8F%AC%EB%A7%B7)

JAR (파일 포맷) - 위키백과, 우리 모두의 백과사전