최근 안드로이드 프로젝트를 진행하면서 AGP(Android Gradle Plugin) 업그레이드를 해야 했던 상황이 있었습니다. 단순히 라이브러리를 추가하려다 시작된 일이었지만, 결국 안드로이드 스튜디오, Gradle, Kotlin 버전까지 줄줄이 업그레이드를 하게 되었죠.
원래는 안정적으로 사용하던 기존 환경을 계속 유지하고 싶었지만, 빌드 오류와 의존성 충돌이 반복되면서 결국 업그레이드를 결정할 수밖에 없었습니다. 이번 글에서는 그 과정과 경험을 정리해보려 합니다.
아래는 제가 업그레이드한 과정입니다.
1. Android Studio 업그레이드
AGP 8.x를 사용하려면 최신 Android Studio가 필요합니다.
저는 기존에 사용하던 Dolphin에서 Koala로 업그레이드했습니다.
Koala 버전은 JDK 17을 내장하고 있어, AGP 8.x 환경에서 공식적으로 권장되는 조합입니다.
Android Studio 아카이브 페이지 에서 원하는 안드로이드 스튜디오 버전을 다운로드할 수 있습니다.
이곳에서는 과거 버전부터 최신 버전까지 모두 제공되므로, 테스트나 버전 맞춤 설치에 유용합니다.
AGP와 Android Studio는 버전 호환성이 매우 중요합니다.
AGP 릴리즈 노트에서 버전 매트릭스를 꼭 확인하시고, 문제가 생기면 버전을 바꿔 가면서 테스트해보는 것이 좋습니다.
2. Gradle 버전 업데이트
저는 8.6.1 을 쓰기 위해서, gradle-wrapper.properties를 아래처럼 수정했습니다.
distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-all.zip
3. 프로젝트 build.gradle 수정
buildscript {
repositories {
google()
mavenCentral()
}
dependencies {
....
classpath 'com.android.tools.build:gradle:8.6.1'
....
}
}
plugins {
id 'com.android.application' version '8.6.1' apply false
id 'com.android.library' version '8.6.1' apply false
....
}
모듈 레벨 build.gradle도 함께 확인해야 합니다.
compileSdk, targetSdk 등도 자신에게 맞게 수정해 주면됩니다. 저는 35를 사용했습니다.
4. Kotlin 버전 체크
AGP 8.x는 최신 Kotlin 버전과 함께 써야 합니다.
저는 Kotlin 1.9.20을 사용중입니다.
./gradlew clean 해주고 다시 빌드해주면 됩니다.
참고 링크
'프로그래밍 > Android' 카테고리의 다른 글
안드로이드 AGP 8.0 사용하면서 생긴 문제 해결 : Android studio 해상도 문제, BuildConfig 생성 (0) | 2025.04.18 |
---|---|
AAR 파일에서 proguard.txt 수정하기 (0) | 2025.03.27 |
Android 4.4 Kitkat 에서 Conscrypt 라이브러리 이용해서 최신 SSL/TLS 버전 지원하기. (2) | 2024.12.20 |
Android enable and disable specific app(package) programmatically (0) | 2024.01.10 |