====== 개인 빌드 (Gradle) ======

===== 설명 =====
Gradle은 Groovy를 기반으로 한 오픈소스 빌드 도구이다. Ant의 자유도와 Maven의 관례를 통한 접근성을 바탕으로 이전 빌드툴의 단점을 보완하여 개선된 서비스를 제공한다.

===== 특징 =====
  * Ant처럼 매우 유연한 범용 빌드 도구.
  * Maven과 같은 구조화 된 build프레임워크 (구조의 전환이 가능).
  * Maven, Ivy등의 기존 저장소 인프라 또는 pom.xml 파일과 ivy.xml 파일에 대한 migration의 편이성 제공
  * 멀티 프로젝트 빌드 지원.
  * 의존성 관리의 다양한 방법 제공
  * Build script를 xml이 아닌 Groovy 기반의 DSL(Domain Specific Language)을 사용
  * 기존 Build를 구성하기 위한 풍부한 도메인 모델 제공.
  * Gradle 설치 없이 Gradle Wrapper를 이용하여 빌드 지원


==== 장점 ====
Ant, Maven과 같은 기존의 빌드툴은 xml형식을 이용하여 정적인 설정정보를 구성했다. \\
Gradle은 Groovy라는 언어를 이용하여 코드로서 설정정보를 구성하기 때문에 구조적인 장점이 있다.

    * xml의 구조적인 틀을 벗어나 코딩에 의한 간결한 정의가 가능하다.
    * 프로젝트를 설정주입방식으로 정의하기 때문에 maven의 상속 구조보다 재사용에 용이하다.

===== 기본구조 =====

  * 모든 Gradle script는 하나 이상의 project로 구성되며, 모든 프로젝트는 하나이상의 task로 구성된다.
    * Project :  소스를 jar로 모으거나, 자바 프로젝트를 컴파일하거나, 테스트를 실행하고, 어플리케이션을 배포하는 등의 업무로 구성된다.
    * Task :  작업의 최소단위이다. \\ Task간 의존관계 설정과 함께 흐름에 따른 구성이 가능하며, 동적인 테스크의 생성도 가능하다. [[https://docs.gradle.org/current/userguide/more_about_tasks.html|Gradle Tasks]]
  * Gradle은 자바6버전 이상의 VM환경에서 사용이 가능하며, 설치를 하거나 gradle wrapper를 이용하여 실행환경을 구성할 수 있다.



==== Build Lifecycle ====
Build 3단계 [[https://docs.gradle.org/current/userguide/build_lifecycle.html|Gradle Build Lifecycle]]
  - 초기화(Initialization) : 빌드 대상 프로젝트를 결정하고 각각에 대한 Project 객체를 생성. \\ settings.gradle 파일에서 프로젝트 구성 (멀티프로젝트, 싱글프로젝트 구분)
  - 구성(Configuration) : 빌드 대상이 되는 모든 프로젝트의 빌드 스크립트를 실행. (프로젝트 객체 구성) \\ configured Task 실행
  - 실행(Execution) : 구성 단계에서 생성하고 설정된 프로젝트의 태스크 중에 실행 대상 결정. \\ gradle 명령행에서 지정한 태스크 이름 인자와 현재 디렉토리를 기반으로 태스크를 결정하여 선택된 Task들을 실행


==== Build 설정파일 ====
  * settings.gradle : 프로젝트 구성 설정.(싱글프로젝트의 경우 생략 가능)
    * Gradle은 멀티프로젝트를 구성하여 프로젝트간의 의존성 및 서브프로젝트, 교차 프로젝트를 구성할 수 있다. [[http://www.gradle.org/docs/current/userguide/multi_project_builds.html|Gradle MultiProject]]
  * build.gradle : 빌드에 대한 모든 기능 정의.

  * 표준프레임워크에 적용한 Gradle 빌드환경의 폴더구조 \\ gradle은 다양한 방식으로 시스템을 구성할 수 있으나, java플러그인을 이용한 표준 리소스 구성을 적용하여 기존 메이븐 프로젝트의 구성을 유지할 수 있다. 
    {{:egovframework:dev3.6:dep:build_tool:gradle:gradlefolder.png?700|폴더구조}}

===== 사용법 =====

build.gradle 파일에 빌드정보를 정의하여 프로젝트에서 사용하는 환경 설정, 빌드방법, 라이브러리 정보 등을 기술함으로서 빌드 및 프로젝트의 관리환경을 구성한다.

==== plugin 설정 ====
plugin은 미리 구성해 놓은 task들의 그룹이며, 특정 빌드과정에 필요한 기본정보를 포함하고, 필요에 따라 정보를 수정하여 목적에 맞게 사용할 수 있다.  \\ 
  *plugin을 이용한 빌드파일 설정 [[https://docs.gradle.org/current/userguide/plugins.html|gradle plugin]]
<code script>
plugins {
    id 'java'
    id 'war'
}

// JDK version source compatibility
sourceCompatibility = 1.8

// project version
version = '1.0'

// War file name
war.baseName = 'sample'

// Web directory, this overrides the default value "webapp"
project.webAppDirName = 'src/main/webapp'
project.buildDir = 'target'
</code>
  * Java 프로젝트를 위해 정의한 'JAVA 플러그인'에서는 compileJava, classes, test, jar 등의 task를 제공한다. [[https://docs.gradle.org/current/userguide/java_plugin.html|Gradle Java Plugin]]
  * Web 프로젝트를 위한 'WAR 플러그인'에서는 어플리케이션 소스를 war파일로 묶어주는 war task를 제공한다. [[https://docs.gradle.org/current/userguide/war_plugin.html|Gradle War Plugin]]


==== 저장소 설정 ====
Gradle은 Maven repository, JCenter repository, Ivy directory 등 다양한 저장소를 지원한다. [[https://docs.gradle.org/current/userguide/artifact_dependencies_tutorial.html#N10660|Gradle repository]]

<code script>
repositories {
    mavenLocal() // maven 로컬 캐시 저장소
    mavenCentral() // maven 중앙 저장소
    maven { url 'https://maven.egovframe.go.kr/maven' } // maven 원격 저장소
}
</code>
  * repositories로 다운로드 받은 jar는 $GRADLE_HOME$\caches\modules-2\files-2.1 경로에 캐시된다.


==== 의존관계 설정 ====
Gradle은 java의 의존성 관리를 위해 다양한 '구성'을 제공하고 있다. [[https://docs.gradle.org/current/userguide/java_plugin.html#sec:java_plugin_and_dependency_management|Gradle Dependency manaement]]
  * implementation : 프로젝트 컴파일 및 실행 과정에서 필요한 라이브러리 
  * compileOnly : 프로젝트 컴파일 과정에서만 필요한 라이브러리 
  * runtimeOnly : 프로젝트 실행 과정에서 필요한 라이브러리. 
  * testCompileOnly : 프로젝트의 테스트 컴파일 과정에서만 필요한 라이브러리. 
  * testRuntimeOnly : 프로젝트의 테스트 실행 과정에서만 필요한 라이브러리. 
의존관계는 group, name, version 순으로 의존성을 기술하며 콜론 (':')으로 구분한다.

<code script>
dependencies {
    implementation('org.egovframe.rte:org.egovframe.rte.ptl.mvc:4.2.0') {
        exclude(module: 'commons-logging')
    }
    implementation 'org.egovframe.rte:org.egovframe.rte.psl.dataaccess:4.2.0'
    implementation 'org.egovframe.rte:org.egovframe.rte.fdl.idgnr:4.2.0'
    implementation 'org.egovframe.rte:org.egovframe.rte.fdl.property:4.2.0'
	implementation 'javax.servlet.jsp.jstl:jstl-api:1.2'
    implementation 'org.apache.taglibs:taglibs-standard-impl:1.2.5'
	implementation 'org.antlr:antlr:3.5'
    implementation 'org.hsqldb:hsqldb:2.7.2'
    providedCompile 'javax.servlet:javax.servlet-api:4.0.1'
}
</code>

==== 개발도구 ====
Eclipse에서 제공하는 Buildship 플러그인 개발도구를 이용한다. \\

  * [[http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:dev2:dep:build_tool:gradle:buildship:%EA%B5%AC%ED%98%84%EB%8F%84%EA%B5%AC_%ED%94%8C%EB%9F%AC%EA%B7%B8%EC%9D%B8_buildship|개발도구 플러그인(Buildship)]] : Buildship Gradle Integration [[http://projects.eclipse.org/projects/tools.buildship]]
    * 프로젝트 생성, 가져오기, Task 확인, Task 실행, Test 실행, 실행취소 기능 지원



==== Gradle 전환 ====
  * 표준프레임워크 Sample 프로젝트를 Maven 프로젝트에서 Gradle로 [[eGovframework:DEV4.2:DEP:Build Tool:toGradle|Build 환경 전환]]
  * 표준프레임워크 Boot Sample 프로젝트를 Maven 프로젝트에서 Gradle로 [[eGovframework:DEV4.2:DEP:Build Tool:boot_togradle|Build 환경 전환]]

===== 참고자료 ====
[[http://gradle.org/]]