[Spring] Gradle 프로젝트를 SpringBoot 프로젝트로 변경하기

이동욱 님의 스프링 부트와 AWS로 혼자 구현하는 웹 서비스책을 공부하며 정리한 내용입니다. 틀린 정보가 있을 수 있으니 주의하시고 댓글로 남겨주시길 바랍니다.

 

우선 build.gradle 맨 위에 다음과 같은 코드를 입력합니다.

buildscript {
    ext{
        springBootVersion = '2.1.7.RELEASE'
    }
    repositories {
        mavenCentral()
        jcenter()
    }
    dependencies {
        classpath("org.springframework.boot::spring-boot-gradle-plugin:${springBootVersion}")
    }
}

위 코드는 이 프로젝트의 플러그인 의존성 관리를 위한 설정입니다. ext라는 키워드는 build.gradle에서 사용하는 전역변수를 설정하겠다는 의미이고 여기선 springBootVersion이라는 전역변수를 생성하고 그 값을 '2.17.RELEASE'로 하겠다는 의미입니다.

apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'

이어서 앞서 선언한 플러그인 의존성들을 적용할 것인지를 결정하는 코드입니다. 자바와 스프링 부트를 사용하기 위한 필수 플러그인이니 항상 추가하면 됩니다.

repositories {
    mavenCentral()
    jcenter()
}

dependencies {
    compile('org.springframework.boot::spring-boot-starter-web')
    testCompile('org.springframework.boot:spring-boot-starter-test')
}

repositories는 각종 의존성 (라이브러리)를 어떤 저장소에서 받을 것인지를 결정합니다. dependencies는 프로젝트 개발에 필요한 의존성들을 선언하는 곳입니다.

build.gradle을 통한 모든 설정을 마쳤다면, refresh를 통해서 build.gradle 파일 내에서 설정한 의존성에 맞는 라이브러리들을 import해옵니다. 그러면 스프링 부트 개발환경 구축이 완료됩니다.

 

주의해야 할 점

springBoot 2.2와 Gradle 5로 오면서 너무 많은 설정들이 변경되어서 실무에서 가장 많이 사용하는 버전은 2.1.x 와 Gradle 4입니다.

따라서 본인의 Gradle 버전과 Spring Boot 버전을 체크할 필요가 있습니다.

Gradle 버전 확인하기

gradle-wrapper.properties파일에서 gradle의 버전을 확인할 수 있습니다. 만약 Gradle의 다운그레이드가 필요하다면, alt+F12 를 사용해 해당 프로젝트의 터미널을 열고,

gradlew wrapper --gradle-version 4.10.2

다음과 같은 코드를 통해서 Gradle의 버전을 변경할 수 있습니다.

혹은, gradle-wrapper.properties 파일에서, distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.4-bin.zip에서 버전을 나타내는 gradle-5.6.4-에 해당하는 부분을 원하는 버전으로 바꾸고 refresh를 통해 다운그래이드 할 수도 있습니다.

 

SpringBoot 버전 확인하기

build.gradle에서, 다음과 같이 되어 있는지 확인합니다.

buildscript {
    ext {
        springBootVersion = '2.1.9.RELEASE'
    }
    repositories {
        mavenCentral()
        jcenter()
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
    }
}

만약 version이 2.2.x로 나타난다면 Version 옆의 의존성 값을 2.1.9 등으로 바꾼 다음 다시 gradle를 refresh하면 됩니다.