The project is using an incompatible version (AGP 8.1.1) of the Android Gradle plugin. Latest supported version is AGP 7.2.2
해당 오류 메시지의 내용을 보자면 다음과 같다.
프로젝트에서 사용 중인 Android Gradle Plugin AGP 버전이, 현재 사용 중인 Gradle 버전과 호환되지 않기 때문이다.
구체적으로 프로젝트에서 AGP 8.1.1 버전을 사용하고 있지만, 현재 설정된 Gradle 버전은 AGP 7.2.2 이하의 버전만 지원된다.
에러 원인: AGP와 Gradle 버전 불일치
프로젝트에서 사용 중인 AGP 8.1.1 버전은 최신 기능과 업데이트를 포함하고 있지만,
현재 설정된 Gradle 버전이 이를 지원하지 않아서 발생하는 호환성 문제이다.
프로젝트 설정에서 최신 AGP 버전을 사용하도록 설정되어있지만,
Gradle 버전이 프로젝트의 설정을 따라가지 못하고 있다.
해결방안: Gradle 버전 업그레이드
- 나의 Gradle 버전을 업그레이드
- 프로젝트의 AGP 버전을 다운그레이드
를 할 수 있지만,
나의 경우 프로젝트 버전을 따라가야 하기 때문에 Gradle 버전을 업그레이드 하기로 한다.
gradle-wrapper.properties 에서 Gradle 버전 수정
최신 AGP 버전을 사용하기 위해서는 → Gradle 버전을 업그레이드 해야 한다.
일반적으로 최신 AGP 버전을 지원하는 Gradle 버전을 사용하면 문제를 해결할 수 있다.
gradle-wrapper.properties 파일을 열고 Gradle 버전을 아래와 같이 최신 버전으로 변경한다.
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-all.zip위처럼 Gradle 버전을 변경한 뒤, 프로젝트를 동기화하고 빌드한다.
Android Studio 자체의 설정을 통해 Gradle 버전 수정
STEP01. Gradle 버전 업그레이드
상단
File>Settings(맥OS의 경우Preference)
왼쪽 패널Build, Execution, Deployment>Gradle메뉴 선택
- Gradle 섹션에서 Gradle JDK 을 JAVA 17이상으로 설정
- Gradle 버전을 확인하고 최신 버전으로 설정한다.
- 만약 자동으로 최신 버전으로 업데이트되지 않았다면, 수동으로 업데이트할 수 있다.
Use default Gradle Wrapper (recommend)메뉴를 선택해서 GradleWrapper가 최신 버전을 사용하도록 한다.
STEP02. Gradle Wrapper 업데이트
Android Studio에서 Gradle Wrapper 파일을 업데이트한다.
상단 메뉴
View>Tool Windows>Terminal메뉴를 열고,
터미널에서 다음 명령어를 실행해서 최신 Gradle 버전을 다운로드 한다.
아래 명령어는,
프로젝트 루트 디렉터리의 gradle-wrapper.properties 파일을 업데이트해서 최신 Gradle 버전을 사용하도록 한다.
$ ./gradlew wrapper --gradle-version=7.5.1 --distribution-type=all