Gradle로 자바 프로젝트 생성 및 실행: 단계별 가이드

Gradle은 현대 자바 개발에서 필수적인 빌드 자동화 도구입니다. 많은 개발자들이 Maven이나 Ant에서 Gradle로 전환하는 이유는 더 유연하고 강력한 기능을 제공하기 때문입니다. 특히 Gradle CLI(Command Line Interface)를 통해 간단한 명령어로 자바 프로젝트를 생성하고 빌드할 수 있어, 복잡한 작업을 자동화하는 데 매우 유리합니다. 이번 포스팅에서는 Gradle을 사용하여 자바 애플리케이션 프로젝트를 생성하고 빌드하는 방법을 알아보겠습니다.

 

Gradle로 자바 프로젝트 생성 및 실행: 단계별 가이드

 

Gradle을 사용한 자바 프로젝트 생성

1. Gradle 프로젝트 폴더 생성

먼저 Gradle 프로젝트를 저장할 폴더를 만들어야 합니다. Gradle을 사용하면 여러 프로젝트를 한곳에서 관리할 수 있기 때문에, 하나의 디렉토리를 만들어 각 프로젝트를 관리하는 것이 좋습니다.

터미널이나 명령 프롬프트에서 다음 명령어를 입력해 Gradle 프로젝트 폴더를 생성합니다:

mkdir GradleProjects
cd GradleProjects
mkdir FirstJavaProject
cd FirstJavaProject

 

이제 FirstJavaProject 폴더가 생성되었으며, 이곳에 Gradle 프로젝트 파일을 저장할 것입니다.

 

 

2. Gradle 프로젝트 초기화

프로젝트 폴더를 생성한 후, Gradle CLI를 사용하여 프로젝트를 초기화할 수 있습니다. Gradle CLI를 사용하면 복잡한 설정 없이도 자바 애플리케이션 프로젝트를 쉽게 생성할 수 있습니다.

다음 명령어를 실행해 Gradle 프로젝트를 초기화합니다:

gradle init

 

 

명령어를 실행하면 몇 가지 질문이 표시됩니다. 이 질문에 대한 답변을 바탕으로 Gradle이 적절한 프로젝트 파일을 생성합니다.

1. 프로젝트 유형 선택: 애플리케이션 프로젝트를 생성할 것이므로, 2를 선택합니다.
2. 프로그래밍 언어 선택: 자바를 사용할 것이므로 3을 선택합니다.
3. 모듈 선택: 단일 모듈 프로젝트를 생성할 것이므로 1을 선택합니다.
4. DSL 선택: Gradle 스크립트를 작성할 언어로 Groovy 또는 Kotlin을 선택할 수 있습니다. 여기서는 Groovy를 선택합니다.
5. 테스트 프레임워크 선택: Gradle은 기본적으로 JUnit을 지원합니다. 여기서는 JUnit 4를 선택합니다.
6. 프로젝트 이름 확인: 기본값으로 폴더 이름인 FirstJavaProject가 사용됩니다. 이름을 변경하고 싶다면 새로운 이름을 입력하고, 그대로 사용하려면 Enter를 누릅니다.
7. 패키지 이름 설정: 패키지 이름을 입력합니다. 여기서는 com.bharath.gradle을 사용하겠습니다.

 

 

이제 Gradle이 프로젝트 파일을 생성하였으며, 이 파일들을 사용하여 자바 애플리케이션을 빌드할 수 있습니다.

 

 

Gradle 프로젝트 파일 구조

Gradle CLI를 통해 프로젝트를 생성하면 여러 파일과 폴더가 자동으로 생성됩니다. 이 중에서 중요한 몇 가지 파일을 살펴보겠습니다.

• build.gradle: 프로젝트의 빌드 설정 파일입니다. 이 파일에서 의존성, 태스크, 플러그인 등을 정의합니다.
• settings.gradle: 프로젝트의 이름과 모듈을 정의하는 파일입니다. 여기서는 프로젝트 이름과 함께 단일 모듈을 포함합니다.
• src/main/java: 애플리케이션 소스 코드가 위치하는 디렉토리입니다. Gradle은 자바 소스 파일을 이곳에서 찾습니다.
• src/test/java: 테스트 코드가 위치하는 디렉토리입니다. JUnit과 같은 테스트 프레임워크를 사용해 테스트를 자동화할 수 있습니다.
• gradle-wrapper: 프로젝트별로 일관된 Gradle 버전을 사용할 수 있도록 지원하는 파일입니다. 이는 팀원이나 CI 환경에서 동일한 Gradle 버전을 사용하는 데 필수적입니다.

 

 

Gradle 프로젝트 파일 설명

1. build.gradle
   이 파일은 프로젝트의 중심이 되는 설정 파일입니다. 자바 프로젝트의 경우, Gradle은 기본적으로 build.gradle에 필요한 설정을 자동으로 추가합니다. 예를 들어, 자바 플러그인과 JUnit 의존성이 추가되어 있습니다.
2. src/main/java
   이 폴더에는 프로젝트의 자바 소스 코드가 저장됩니다. Gradle은 이 디렉토리를 기본적으로 컴파일 대상으로 인식합니다. 프로젝트 생성 시 기본 클래스로 App.java가 생성되며, 이 파일에서 간단한 자바 애플리케이션의 기본 구조를 확인할 수 있습니다.
3. src/test/java
   이 폴더에는 프로젝트의 테스트 코드가 저장됩니다. 생성된 AppTest.java 파일에는 간단한 JUnit 테스트가 포함되어 있습니다. 이 테스트는 App.java의 메서드를 검증하는 역할을 합니다.

 

 

Gradle 태스크 실행하기

Gradle 프로젝트가 생성되었으니, 이제 Gradle 태스크를 실행하여 프로젝트를 빌드하고 실행할 수 있습니다. Gradle은 빌드, 테스트, 클린 등 다양한 태스크를 기본적으로 제공합니다.

 

1. Gradle 태스크 목록 확인

Gradle은 여러 가지 기본 태스크를 제공하며, 이 태스크들은 gradle tasks 명령어를 통해 확인할 수 있습니다:

gradle tasks

 

이 명령어를 실행하면 프로젝트에서 실행 가능한 모든 태스크 목록을 확인할 수 있습니다.

 

 

2. 빌드 태스크 실행

gradle build 명령어를 사용하여 프로젝트를 빌드할 수 있습니다. 이 명령어는 소스 코드를 컴파일하고, 테스트를 실행하며, 빌드 결과물을 생성합니다:

gradle build

 

빌드가 성공적으로 완료되면, build 폴더에 결과물이 생성됩니다. 여기에는 컴파일된 .class 파일과 함께 테스트 결과, 실행 가능한 .jar 파일이 포함됩니다.

 

 

3. 애플리케이션 실행

Gradle로 빌드된 애플리케이션을 실행하려면, gradle run 명령어를 사용합니다. 이 명령어는 src/main/java 디렉토리에 있는 App.java 파일을 실행합니다:

gradle run

 

이 명령어를 실행하면, App.java 파일에서 정의한 getGreeting() 메서드가 호출되어 "Hello, World!"와 같은 출력 결과를 확인할 수 있습니다.

 

 

Gradle Wrapper 사용하기

Gradle Wrapper는 프로젝트별로 일관된 Gradle 버전을 사용할 수 있도록 지원하는 기능입니다. 이는 특히 팀 작업이나 CI/CD 파이프라인에서 중요한 역할을 합니다. 각 개발 환경이나 빌드 서버에서 동일한 Gradle 버전을 사용함으로써, 빌드 실패를 방지할 수 있습니다.

Gradle Wrapper는 프로젝트 생성 시 자동으로 생성되며, gradlew 명령어를 통해 실행할 수 있습니다. 예를 들어, 다음 명령어를 사용해 프로젝트를 빌드할 수 있습니다:

./gradlew build

 

Gradle Wrapper는 설정된 버전의 Gradle을 자동으로 다운로드하고, 이를 사용해 빌드를 수행합니다. 이를 통해 각 환경에서 동일한 버전의 Gradle을 사용할 수 있게 됩니다.

 

 

결론

이번 포스팅에서는 Gradle을 사용하여 자바 애플리케이션 프로젝트를 생성하고, 빌드 및 실행하는 방법을 알아보았습니다. Gradle CLI를 사용하면 복잡한 설정 없이도 간단하게 프로젝트를 생성할 수 있으며, 다양한 기본 태스크와 커스텀 태스크를 통해 프로젝트를 효율적으로 관리할 수 있습니다.

또한 Gradle Wrapper를 통해 일관된 빌드 환경을 유지할 수 있으며, 이를 통해 팀 프로젝트와 CI 환경에서의 호환성을 보장할 수 있습니다. Gradle의 강력한 기능을 활용하여 더 효율적인 개발 환경을 구축해보세요.