OKdevTV

Gradle

• https://gradle.org
• 강력한 빌드 자동화 도구
• 현재 최신 버전: Gradle 8.7 (2025년 5월 기준)

설치 방법

SDKMAN을 통한 설치 (권장)

• sdkman

sdk install gradle

macOS에서 설치

brew install gradle

Windows에서 설치

• Chocolatey 사용

choco install gradle

• Scoop 사용

scoop install gradle

수동 설치

1. Gradle 다운로드 페이지에서 최신 버전 다운로드
2. 압축 해제 후 환경 변수 PATH에 bin 디렉토리 추가

기본 명령어

# 프로젝트 빌드
gradle build

# 테스트 건너뛰고 빌드
gradle build -x test

# Spring Boot 애플리케이션 실행
gradle bootRun

# Gradle Wrapper 사용 (권장)
./gradlew build
./gradlew bootRun

프로젝트 시작하기

새 프로젝트 초기화 (권장)

# 새 디렉토리 생성
mkdir my-project
cd my-project

# Gradle 초기화 (대화형)
gradle init

수동으로 시작하기

mkdir basic-demo
cd basic-demo
touch build.gradle

Gradle 태스크 확인

# 모든 태스크 보기
gradle tasks --all

# 기본 태스크 보기
gradle tasks

의존성 범위 (Dependency Scope)

• implementation : 컴파일 및 런타임에 필요, API는 노출되지 않음 (권장)
• api : 컴파일 및 런타임에 필요, API가 노출됨
• compileOnly : 컴파일 시에만 필요 (런타임에는 불필요)
• runtimeOnly : 런타임에만 필요
• testImplementation : 테스트 컴파일 및 실행에만 필요
• testCompileOnly : 테스트 컴파일에만 필요
• testRuntimeOnly : 테스트 실행에만 필요

build.gradle 예제

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.2.0'
    id 'io.spring.dependency-management' version '1.1.4'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'

java {
    sourceCompatibility = '17'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    runtimeOnly 'com.h2database:h2'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}

커스텀 태스크 정의

// 파일 복사 태스크
task copy(type: Copy) {
    from 'src'
    into 'dest'
}

// ZIP 파일 생성 태스크
task zip(type: Zip) {
    from 'src'
    archiveFileName = 'archive.zip'
}

Gradle Daemon

• Gradle 성능 향상을 위한 백그라운드 프로세스
• 빌드 정보를 메모리에 유지하여 후속 빌드 시간 단축

데몬 상태 확인

# 현재 실행 중인 모든 Gradle 데몬 상태 확인
gradle --status

데몬 중지 방법

# 모든 Gradle 데몬 중지
gradle --stop

# 특정 프로세스 ID로 데몬 중지 (Linux/macOS)
kill -9 <PID>

# 실행 중인 Gradle 데몬 찾기 (Linux/macOS)
ps -ef | grep gradle

# 실행 중인 Gradle 데몬 찾기 (Windows)
tasklist | findstr gradle

데몬 설정

gradle.properties 파일에 다음 설정 추가:

# 데몬 비활성화 (항상 새 프로세스에서 빌드 실행)
org.gradle.daemon=false

# 데몬 JVM 메모리 설정
org.gradle.jvmargs=-Xmx2g -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError

데몬 자동 종료

• 기본적으로 3시간 동안 사용되지 않으면 자동 종료
• 설정 변경:

# 데몬 유휴 시간 설정 (밀리초 단위, 예: 1시간)
org.gradle.daemon.idletimeout=3600000

데몬 문제 해결

• 빌드가 예상대로 작동하지 않을 때 데몬을 중지하고 다시 시작
• 메모리 부족 오류 발생 시 JVM 메모리 설정 증가
• 데몬 로그 확인: ~/.gradle/daemon/<버전>/daemon-<PID>.out.log

Gradle Wrapper (권장)

• Gradle이 설치되지 않은 환경에서도 빌드 가능
• 프로젝트에 특정 Gradle 버전 고정
• Wrapper 생성

gradle wrapper

• Wrapper 버전 지정

gradle wrapper --gradle-version=8.7

• Wrapper 사용

./gradlew build  # Linux/macOS
gradlew.bat build  # Windows

커스텀 리포지토리 설정

repositories {
    mavenCentral()
    
    maven {
        url 'https://repo.mycompany.com/maven2'
        credentials {
            username = 'username'
            password = 'password'
        }
    }
    
    // JCenter는 더 이상 권장되지 않음
    // jcenter()
}

명령줄 인자 전달

# Spring Boot 애플리케이션에 인자 전달
./gradlew bootRun --args='--server.port=9090 --spring.profiles.active=dev'

멀티 프로젝트 구성

// settings.gradle
rootProject.name = 'my-project'
include 'app', 'library'

// root build.gradle
allprojects {
    repositories {
        mavenCentral()
    }
}

subprojects {
    apply plugin: 'java'
    
    dependencies {
        testImplementation 'org.junit.jupiter:junit-jupiter:5.9.2'
    }
}

Gradle vs Maven 비교

특성	Gradle	Maven
빌드 스크립트	Groovy 또는 Kotlin DSL (간결하고 유연함)	XML (상대적으로 장황하고 경직됨)
성능	증분 빌드, 빌드 캐시, 병렬 실행으로 더 빠름	상대적으로 느림
의존성 관리	동적 버전, 전이적 의존성 제외, 세밀한 제어	중앙 저장소, 전이적 의존성 관리
커스터마이징	매우 유연하고 확장 가능한 플러그인 시스템	플러그인 시스템이 있지만 덜 유연함
학습 곡선	더 가파른 학습 곡선 (유연성으로 인해)	상대적으로 배우기 쉬움
IDE 지원	주요 IDE에서 지원	주요 IDE에서 광범위하게 지원
커뮤니티	성장 중이지만 Maven보다 작음	오랜 역사와 큰 커뮤니티
적합한 프로젝트	복잡하고 대규모 프로젝트, 커스텀 빌드 로직	표준적인 빌드 프로세스를 가진 프로젝트

Gradle의 장점

• 성능: 증분 빌드와 빌드 캐시로 Maven보다 최대 100배 빠를 수 있음
• 간결성: 보일러플레이트 코드가 적고 더 읽기 쉬운 빌드 스크립트
• 유연성: 빌드 로직을 프로그래밍 방식으로 작성 가능
• 의존성 관리: 더 세밀한 제어와 충돌 해결 메커니즘 제공
• 빌드 캐시: 태스크 출력을 캐시하여 빌드 시간 단축

Maven의 장점

• 표준화: 잘 정의된 빌드 라이프사이클과 구조
• 안정성: 오랜 기간 검증된 도구
• 문서화: 풍부한 문서와 예제
• 플러그인 생태계: 광범위한 플러그인 지원
• 학습 용이성: XML 기반으로 배우기 쉬움

전환 고려사항

Maven에서 Gradle로 전환을 고려한다면:

• 기존 Maven 프로젝트는 gradle init 명령으로 쉽게 변환 가능
• 대규모 프로젝트일수록 Gradle의 성능 이점이 두드러짐
• 복잡한 빌드 로직이 필요한 프로젝트에 Gradle이 더 적합
• 팀의 학습 곡선과 적응 시간을 고려해야 함

참고 자료

• Gradle 공식 가이드
• Spring Boot with Gradle
• Gradle 빌드 성능 최적화

What Else?

-50% 할인쿠폰: 20652-ab1f1cd4c373