빌드 시 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 버전을 다운 받기로 했다.

 

https://gradle.org/releases/

Gradle | Releases

 

위 사이트가 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를 다시 넣어준다.

 

그리고 다시 빌드하면 성공적으로 빌드가 되었다!