Unity, Gradle 버전 빌드 애러

인트로

2018.4(LTS) 버전의 유니티를 사용하는 오래된 프로젝트에서 간만에 빌드를 하려니 빌드가 실패했습니다. 빌드 애러 로그 중에서 가장 싫어하는 Gradle 애러가 나왔습니다. Gradle 애러는 가끔 앞뒤 없이 나오는 경우가 있어서, 어디가 문제인지 가끔 찾기 힘든 애러로 난감한 경우가 많습니다.

애러 전문

다행히도 버전 이슈로 명확하게 나와서 수정을 했습니다. 2018.4의 내장된 Gradle 버전은 5.1.1이며, 빌드에서 요구하는 Gradle 버전은 6.1.1로 나왔습니다.

CommandInvokationFailure: Gradle build failed. 
/Applications/Unity/Hub/Editor/2018.4.31f1/PlaybackEngines/AndroidPlayer/Tools/OpenJDK/MacOS/bin/java -classpath "/Applications/Unity/Hub/Editor/2018.4.31f1/PlaybackEngines/AndroidPlayer/Tools/gradle/lib/gradle-launcher-5.1.1.jar" org.gradle.launcher.GradleMain "-Dorg.gradle.jvmargs=-Xmx4096m" "assembleRelease"

stderr[

FAILURE: Build failed with an exception.

* Where:
Build file '/Users/USER_NAME/.jenkins/workspace/A_Project/Temp/gradleOut/build.gradle' line: 59

* What went wrong:
A problem occurred evaluating root project 'gradleOut'.
> Failed to apply plugin [id 'com.android.internal.version-check']
   > Minimum supported Gradle version is 6.1.1. Current version is 5.1.1. If using the gradle wrapper, try editing the distributionUrl in /Users/haegindev/.jenkins/workspace/OverDox/OverDox_DevBuild/OverDox_DEV_Build_Android/Temp/gradleOut/gradle/wrapper/gradle-wrapper.properties to gradle-6.1.1-all.zip

* 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.

해결 방법

1. https://gradle.org/releases/로 이동하여 요구하는 버전의 Gradle을 다운로드합니다. (저의 경우 v6.1.1)
2. 내장된 Gradle을 찾아가줍니다.
   (윈도우OS : C:\Program Files\Unity\Hub\Editor\2018.4.31f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle)
   (맥OS: Applications/Unity/Hub/Editor/2018.4.31f1/PlaybackEngines/AndroidPlayer/Tools)
3. 다운로드한 Gradle에서 'lib'폴더로 교체해줍니다. (내장된 Gradle은 제거하거나 백업합니다.)

내장된 Gradle 라이브러리

 

마무리

저의 경우 팀 프로젝트여서, 회사에서 공용으로 사용하는 각종 플러그인에 의해 Gradle 버전이 영향을 받다보니 갑자기 어느 순간부터 Gradle 버전이 낮다는 이슈가 생겼습니다. Gradle은 유니티 내장이기 때문에, 유니티를 높이는 방법도 있지만, 이게 현실적으로는 어려운 경우가 대다수죠..😅 저 역시 팀 프로젝트라 어떻게 할 수 없었습니다. 그래도 버전을 강제로 수정하니 좀 찜찜하지만, 해결은 되었습니다. 저와 같은 고생을 하는 개발자 분에게 빌드하는데 도움되기를 바랍니다.

---

참고(포럼): https://forum.unity.com/threads/gradle-build-fails-with-build-tools-31-0-0.1154834/

참고(포럼): https://discussions.unity.com/t/change-version-of-gradle-to-4-6/206392

참고(티스토리): https://chc3484.tistory.com/74

참고(가이드 문서): https://docs.unity3d.com/kr/2021.1/Manual/android-gradle-overview.html