빌드 시 Gradle 에러 해결방법
열심히 개발하고 빌드해서 테스트 해볼려 했더니 갑자기 이런 에러가..
GPT 한테 물어보고 이것저것 다 해봤지만 계속 안됐다.
뭐.. 대충 이런 에러라는데 잘 모르겠고 그냥 Gradle이라는게 문제인거같다.
그래서 Gradle이 무엇이냐...
🔹 Gradle 핵심 개념 정리
✅ 1. Gradle의 의미
- 빌드 자동화 도구
- Java, Kotlin, C++, Android 등 다양한 프로젝트의 컴파일, 빌드, 테스트, 배포를 자동화
✅ 2. Gradle의 역할
- 코드 컴파일 & 패키징 → 소스 코드 → .apk 또는 .aab 파일 생성
- 의존성(Dependency) 관리 → 필요한 라이브러리 자동 다운로드
- 멀티플랫폼 지원 → 다양한 언어(Java, Kotlin 등)와 연동 가능
- 빌드 속도 최적화 → 캐싱 및 병렬 실행으로 빠른 빌드 수행
✅ 3. Gradle 버전과 중요성
- Gradle 버전이 중요한 이유
- Android SDK, 플러그인, 최신 기능과 호환성 유지
- 낮은 버전 사용 시 최신 기능 미지원, 빌드 오류 발생 가능
- 일반적인 Gradle 버전 관리 방법
- gradle-wrapper.properties 파일에서 distributionUrl 변경
- 최신 Gradle 다운로드 후 Unity 또는 Android Studio에서 직접 설정
✅ 4. Gradle이 중요한 이유
- 개발 생산성 향상 → 수동 작업 없이 자동 빌드
- 모듈화된 프로젝트 관리 가능 → 대형 프로젝트에도 적합
- Android 앱 필수 빌드 도구 → Android Studio & Unity(Android 빌드)에서 기본 사용
요약해서 Unity에서 요구하는 Gradle 버전과 현재 Unity Gradle 버전이 맞지 않는 것 같다.
CMD로 강제로 업그레이드도 해보고 파일 삭제도 해보고 코드도 수정해보고 여러가지 해봤지만 잘 안 됐다.
그래서 결국 Gradle 버전을 다운 받기로 했다.
Gradle | Releases
Find binaries and reference documentation for current and past versions of Gradle.
gradle.org
위 사이트가 Gradle을 버전별로 다운 받을 수 있는 사이트다.
빌드 에러 디버그 메세지를 자세히 보니
Minimum supported Gradle version is 7.5. Current version is 7.2.
다음과 같은 에러메세지가 있었다.
Unity : 나는 최소 7.5버전을 호환하는데 너는 7.2버전이야.
그래서 7.5버전을 다운 받아줬다. (binary-onley)
이건 Unity 프로젝트가 아닌 버전 문제기 때문에
Unity 버전안에 있는 Gradle을 업그레이드 해줘야 하는 것 같았다. (내 프로젝트는 나는 2022.3.16f1이라서 3.16 Gradle 을 수정했다)
☆ 경로 -> "C:\Program Files\Unity\Hub\Editor\2022.3.16f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle\lib"
위 경로에 있는 lib 파일을 삭제 후 다운 받은 새로운 버전의 Gradle 파일을 압축 해제 후 lib를 다시 넣어준다.
그리고 다시 빌드하면 성공적으로 빌드가 되었다!