Gradle

개요
특징
명령
자주 보는 dependency 설정들
팁 모음
- 호환되는 언어 버전을 알고 싶다면
- 의존 라이브러리 단축 표기법
문제 해결 경험
- Gradle 6.1.1 - org.codehaus.groovy.runtime.InvokerHelper
Links
참고문헌
Endnote

개요

개발자: Hans Dockter, Adam Murdoch, Szczepan Faber, Peter Niederwieser, Luke Daley, Rene Gröschke, Daz DeBoer, Steve Appling
라이선스: Apache License 2.0
개발 언어: Java, Groovy 등¹

특징

앤트나 메이븐은 이러한 빌드 언어 대신 XML을 사용한다. 하지만 XML은 원래 범용 문서 형식이라 언어 처리 기능은 없다. 따라서 조건 분기나 반복 기능을 구현하려면 앤트와 메이븐에서 구조를 바꿔서 직접 해당 기능을 만들어야 한다. 반면 그레이들의 DSL은 그루비로 구축되어 있어서 그루비가 제공하는 언어 기능을 그대로 이용할 수 있다. 게다가 그루비는 자바 클래스를 직접 호출할 수 있으므로 빌드 스크립트에서 자바 유틸리티도 쉽게 사용할 수 있다.²

명령

 # 이전에 빌드한 파일을 삭제한다
gradle clean

 # 빌드한다
gradle build

 # 테스트를 실행한다
gradle test

 # build.gradle 파일에서 mainClassName으로 지정한 메인 클래스를 실행한다
gradle run

자주 보는 dependency 설정들

java 플러그인에서 정의된 설정들

Dependency configurations

implementation: extends compile. compile은 deprecated 되었으므로, compile 대신 사용하면 된다.
annotationProcessor: Annotation processors used during compilation.
compileOnly: Compile time only dependencies, not used at runtime.

Deprecated

compile: 컴파일 타임 의존관계. 3 버전부터 deprecated.
- implementation으로 대체되었다.
testCompile: extends compile.
- testImplementation으로 대체되었다.
runtime: extends compile.
- runtimeOnly로 대체되었다.
testRuntime: extends runtime, testCompile.
- testRuntimeOnly로 대체되었다.

task 이름 축약

태스크명이 카멜 케이스로 되어 있다면 첫 글자와 각 대문자만 입력하는 방식으로 축약 명령을 쓸 수 있다.

$ gradle bootRun
$ gradle bR         # gradle bootRun 과 같다
$ gradle br         # 실패! 이건 축약으로 인식이 안 된다

$ gradle generateGitProperties
$ gradle gGP        # gradle generateGitProperties 와 같다

Hello, World!

다음과 같이 build.gradle 파일을 작성하여, hello task를 만들어 준다.

task hello << {
    println('Hello, World!')
}

이후 $ gradle hello를 실행하면 다음과 같이 출력된다.

The Task.leftShift(Closure) method has been deprecated and is scheduled to be removed in Gradle 5.0. Please use Task.doLast(Action) instead.
        at build_2m7yvivnk61zadzdb3s3blnfb.run(/Users/johngrib/git/gradle-study/build.gradle:1)
:hello
Hello, World!

BUILD SUCCESSFUL

Total time: 0.979 secs

JVM heap 사이즈 설정

 # Gradle 실행시 JVM 최대 힙 사이즈를 1GB로 설정한다.
export GRADLE_OPTS=-Xmx1024m

테스트 하나만 구동하기

gradle clean test --tests "package.class.method"

spring.profile.active 설정하기

SpringBoot를 사용한다면 다음과 같이 액티브 프로파일을 설정해 한 줄로 실행할 수 있다.³

$ SPRING_PROFILES_ACTIVE=local2 gradle bootrun
$ SPRING_PROFILES_ACTIVE=local2 ./gradlew bootrun     # gradlew 사용

물론 커맨드라인으로도 가능하다.

./gradlew bootRun -Dspring.profiles.active=local2

팁 모음

호환되는 언어 버전을 알고 싶다면

다음 문서를 보면 된다.

https://docs.gradle.org/current/userguide/compatibility.html

의존 라이브러리 단축 표기법

다음과 같이 dependencies가 정의되어 있다고 하자. 잘 보면 세미콜론(:)이 구분자로 사용되고 있는데, 이는 단축 표기법을 사용해 생략한 것이다.

dependencies {
  compile 'org.slf4j:slf4j-api:1.7.5'
}

단축 표기법을 사용하기 싫다면 다음과 같이 하면 된다.

dependencies {
  compile group:'org.slf4j', name:'slf4j-api', version: '1.7.5'
}

문제 해결 경험

Gradle 6.1.1 - org.codehaus.groovy.runtime.InvokerHelper

Gradle 6.1.1 버전을 사용할 때 빌드를 돌려 보았더니 다음과 같은 에러가 발생했다.

$ ./gradlew build

FAILURE: Build failed with an exception.

* What went wrong:
Could not initialize class org.codehaus.groovy.runtime.InvokerHelper

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 510ms

이때 사용하고 있었던 /gradle/wrapper/gradle-wrapper.properties는 다음과 같다.

# Gradle 6.1.1 버전을 사용하고 있음
distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-all.zip
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStorePath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME

문제의 원인은 버전 Gradle 6.1.1 버전이 Java 16버전을 지원하지 않기 때문에 발생한 문제였다.

해결책은 둘 중 하나일 것이다.

Java 16 버전을 지원하는 Gradle 버전을 사용한다.
Gradle 6.1.1 이 지원하는 Java 버전을 사용한다.

Java 버전을 11 버전으로 낮춰주었더니 빌드가 잘 되었다.

참고문헌

Gradle 그레이들 철저 입문 / 와타비키 타쿠마, 스에 노부히로, 하야시 마사토시, 이마이 마사노부 공저 / 김완섭 역 / 길벗 / 2015년 12월 28일
실전 자바 소프트웨어 개발 / 라울-게이브리얼 우르마, 리처드 워버턴 저/우정은 역 / 한빛미디어 / 초판 1쇄 2020년 06월 20일 / 원제 : Real-World Software Development

개요

특징

명령