[android] build.gradle의 버전 세팅하기

android studio에서 처음 flutter project를 생성하고 시뮬레이터에서 구동하면 gradle 버전 오류가 발생한다.

프로젝트 생성 시 자동으로 세팅되는 버전은 AGP: 8.1.0 / gradle : 8.4로 되어 있다.(현재 NarWhal 2025 버전)

android studio 홈페이지에서도 버전 호환 정보를 확인 할 수 있다.

android SDK의 버전이 매년 업데이트 되면서 호환성 문제가 발생하는듯 하다.

 

AGP 과 gradle

그전에 AGP와 gradle를 알아야 한다.

gradle는 쉽게 말해 범용 빌드 도구 이다. kotlin, java 의 빌드 자동화 도구라고 생각하면 된다.

AGP(android gradle plugin)으로 gradle를 안드로이드 용으로 사용하기 위한 plugin 이다.

그래서 아무 버전을 사용해서는 안된다. IDE / AGP / gradle 가 서로 호환되는 버전으로 사용해야 안전하다.

(사실 호환 되지 않으면 시뮬레이터에 빌드 자체가 안된다.)

 

업데이트 위치

AGP는 /android/build.gradle 파일에 존재 한다.

plugins {
id "dev.flutter.flutter-plugin-loader" version "1.0.0"
id "com.android.application" version "8.1.0" apply false
id "org.jetbrains.kotlin.android" version "1.8.22" apply false
}

여기서 id "com.android.application" version "8.1.0" apply false 이부분의 버전 정보를 수정해 주면 된다.

 

gradle은 /android/gradle/gradle-wrapper.properties 에서 수정해 주면 된다.

distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip

똑같이 버전 숫자를 수정해 주면 된다.

 

참고사항

* android studio를 다운 받을 때, IDE의 설명을 보면 안정화 AGP 버전 정보가 있고, 호환 gradle 정보가 있으니 잘 찾아 보면 된다.ㅎ

* 참고로 AGP/gradle의 버전이 변경 되면 id "org.jetbrains.kotlin.android" version "1.8.22" apply false 이 kotlin버전도 업데이트 해줘야 한다. 최신 버전으로 업데이트 해주면 된다.

* gradle의 버전이 8.6이상이 되면 Java의 버전을 17 버전 이상으로 업데이트 해줘야 한다. 현재 가장 안정적이고 범용적인 버전이 java17 이라고 알고 있다. 미리 java 17로 세팅해 놓자.

 

끝.