안드로이드 스튜디오 Gradle build failed

안드로이드 앱을 개발하다보면 아래와 같은 에러를 종종 볼 수 있게 됩니다.

 

"Gradle build failed" 이 에러 문구의 에러가 워낙 많아서 구글에서도 가이드를 해놓았습니다.

 

1. Android Gradle 플러그인 업데이트

Android 스튜디오를 업데이트하면 Android Gradle 플러그인을 사용 가능한 최신 버전으로 자동 업데이트하라는 메시지가 표시될 수 있습니다. 업데이트를 수락하거나 프로젝트의 빌드 요구사항에 따라 버전을 수동으로 지정할 수 있습니다.
Android 스튜디오의 File > Project Structure > Project 메뉴 또는 최상위 build.gradle 파일에서 플러그인 버전을 지정할 수 있습니다. 플러그인 버전은 Android 스튜디오 프로젝트에 빌드된 모든 모듈에 적용됩니다. 

다음 예는 build.gradle 파일에서 플러그인을 버전 7.4.0으로 설정합니다.

plugins {
    id("com.android.application") version "7.4.0" apply false
    id("com.android.library") version "7.4.0" apply false
    id("org.jetbrains.kotlin.android") version "1.5.31" apply false
}

 

 

2. Gradle 업데이트
Android 스튜디오를 업데이트하면 Gradle 또한 사용 가능한 최신 버전으로 업데이트하라는 메시지가 표시될 수 있습니다. 업데이트를 수락하거나 프로젝트의 빌드 요구사항에 따라 버전을 수동으로 지정할 수 있습니다.

다음 표는 각 버전의 Android Gradle 플러그인에 필요한 Gradle 버전을 보여줍니다. 최상의 성능을 위해서는 Gradle과 플러그인을 가능한 최신 버전으로 사용해야 합니다.

 

플러그인 버전필요한 최소 Gradle 버전

8.1	8.0
8.0	8.0
7.4	7.5
7.3	7.4
7.2	7.3.3
7.1	7.2
7.0	7.0
4.2.0+	6.7.1

 

3. Gradle Sync up

버전을 맞추고 나면 꼭 File - > Sync Project withGradle Files 버튼을 클릭해서 싱크업을 해줘야합니다.

 

4. 그외의 경우

이처럼 gradle의 빌드 버전을 변경하는것으로 대부분의 오류를 해결이 가능합니다.

간혹 버전을 맞추어도 에러가 발생할 경우가 있는데, 이럴때는 Android Studio를 삭제하고 다시 설치해보는것도

많은 이슈를 해결하는 솔루션입니다.