[Linux-Ubuntu] gradle version upgrade 버전 낮아서 오류시

 

gradle version이 낮은 경우 아래 처럼 build 오류가 나고, gradle 버전이 낮아서 그렇다는 상세한 설명까지 해준다.

 

* Where:
Build file '/home/yunji/company.project/clean_car123/build.gradle' line: 2

* What went wrong:
An exception occurred applying plugin request [id: 'org.springframework.boot', version: '2.6.7']
> Failed to apply plugin [id 'org.springframework.boot']
   > Spring Boot plugin requires Gradle 6.8.x, 6.9.x, or 7.x. The current version is Gradle 5.6.4

 

 

gradle 버전을 업그레이드 해보자.

기본 local에 설치된 gradle이 있고 프로젝트 별 설정된 gradle을 사용할 수도 있다.

특정 프로젝트의 gradle 를 사용하지 않고 기본으로 설정된 명령어 gradle을 사용하면, local에 설정된 기본 gradle로 구동이 된다.

 

 

먼저, 기본으로 설치되어 있는 gradle 버전을 upgrade 해보자. 

내 경우 gradle 5.6.4 버전이 현재 사용중이다. 매우매우 낮음....ㅎ

 

//gradle 버전확인
gradle -v

 

 

실제 gradle 명령어가 참조하는 bin을 추적해보자.

usr/bin/gradle -> etc/alternatives/gradle -> usr/lib/gradle/5.6.4/bin/gradle 을 참고 하고 있는 것을 확인할 수 있다.

which gradle

위의 결과로 update-alternatives 명령어로 gradle 버전을 변경할 수 있다는 것을 여기서 추측 할 수 있다.

후훗.

 

update-alternatives 명령어는 다양한 버전을 사용할 수 있도록 bin파일의 경로를 간편하게 바꿔준다.

자세한 사용법은 구글링하면 많이 나오니 참고!

 

 

일단, 사용할 gradle 파일을 https://gradle.org/install/ 사이트에가서 받는다.

내 경우 다른 버전의 gradle 파일 또한 /usr/lib/gradle 아래에 존재하므로 해당 폴더에 bin파일을 풀었다.

 

//다운로드 한 파일을 특정 폴더에 지정하여 푼다.
sudo unzip -d /usr/lib/gradle gradle-7.4.2-bin.zip

//해당 파일을 gradle 링크에 등록한다.
sudo update-alternatives --install /usr/bin/gradle gradle /usr/lib/gradle/gradle-7.4.2/bin/gradle 1

// gradle 버전 변경
sudo update-alternatives --config gradle

 

다시 버전 확인해보면 정상적으로 변경된 것을 확인가능하다.

 

 

각 프로젝트 별로 gradle을 사용할 수 있다.

 

//해당 프로젝트 위치로 이동해서 버전 확인
./gradlew -v

 

해당 gradle 버전을 변경하기 위한 방법은 아래와 같다.

./gradlew wrapper --gradle-version 7.4.1

 

근데, version downgrade 시에는 위의 명령어가 잘 동작하지만, upgrade시 오류 발생으로 upgrade가 안되는 경우가 있다. 내경우, 오류발생. 이때 번거롭지만 해결방법이 있다. 해당 프로젝트 폴더/gradle/wrapper/gradle-wrapper.properties를 수정해준다.

 

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.1-bin.zip <<< 이 부분을 원하는 버전으로 수정 후 저장.
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

 

 

나는 gradle 7.4로 변경했다.

 

distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-bin.zip

 

그리고 다시 ./gradlew -v 버전 확인하면!

자동으로 7.4 데이터를 가져와서 7.4 로 설정되는 것을 확인 가능하다.

 

끝!