경고 메시지 발생
구글 플레이에 출시되어 있는 앱을 API 34 수준의 요구사항을 타겟팅을 해야 하는 작업에 앞서,
안드로이드 스튜디오에서 다음과 같은 경고 메시지가 출력되었다.
We recommend using a newer Android Gradle plugin to use compileSdk = 34
This Android Gradle plugin (8.0.2) was tested up to compileSdk = 33.
You are strongly encouraged to update your project to use a newer
Android Gradle plugin that has been tested with compileSdk = 34.
If you are already using the latest version of the Android Gradle plugin,
you may need to wait until a newer version with support for compileSdk = 34 is available.
이 말은 즉, 특정 SDK의 API를 사용하려면 안드로이드 그레이들의 플러그인을 최신화하란 말이다.
내 경우의 상황을 인터넷 검색으로 알아본 결과,
스택 오버 플로우에서 어느 한 답변에 의하면 8.1.1 버전 이상으로 올리라고 하는데
아무리 업데이트를 확인해보아도 안드로이드 스튜디오에서는 8.0.2 버전이 최신이란다.
같은 오류 내용으로 포스팅한 바가 있지만,
이번엔 조금 더 자세한 원인과 해결방법을 알게 되어 이 내용을 새로이 공유하고자 글을 남긴다.
이전 글의 내용을 보고 싶다면 아래의 링크를 참고하자.
원인
알고보니 안드로이드 스튜디오와 안드로이드 그레이들 플러그인이 각각 버전별로 호환성이 다르기 때문이다.
쉽게 말하면, 안드로이드 스튜디오 버전에 따라 지원되는 그레이들의 버전이 있다는 것이다.
안드로이드 스튜디오 페이지에서 확인한 내용에 따르면 다음과 같다.
* 여기서 AGP란, Android Gradle Plugin의 약자로, 흔히 알고 있는 그레이들을 의미한다.
| Android 스튜디오 버전 | 필요한 AGP 버전 |
| 무당벌레 | 2024년 2월 1일 | 3.2~8.7 |
| 코알라 기능 출시 | 2024년 1월 2일 | 3.2~8.6 |
| 코알라 | 2024년 1월 1일 | 3.2~8.5 |
| 해파리 | 2023년 3월 1일 | 3.2~8.4 |
| Iguana | 2023.2.1 | 3.2~8.3 |
| Hedgehog | 2023.1.1 | 3.2-8.2 |
| Giraffe | 2022.3.1 | 3.2~8.1 |
| Flamingo | 2022.2.1 | 3.2~8.0 |
(출처 : 안드로이드 스튜디오 공식 레퍼런스 - 새로운 기능)
자신의 안드로이드 스튜디오 버전을 확인하는 방법은
안드로이드 스튜디오 메뉴에서 'Help - About' 를 차례로 눌러보자.
나 같은 경우에는 Android Studio Flaming였다.
페이지에서 안내한 내용 그대로 내 안드로이드 스튜디오는 최대 8.0까지만 지원하지 않으니
8.0.2 이후 업데이트가 없다고 나온 것이었다.
해결 방법
안드로이드 스튜디오에 호환되는 버전으로 업그레이드
compileSdk에 맞는 최소 AGP(Android Gradle Plugin) 버전을 사용하려면
안드로이드 스튜디오 버전 업그레이드를 통해 그레이들의 버전을 올려 해결할 수 있다.
안드로이드 스튜디오에서 'Help - Check for Updates'를 누르자.
만약 업데이트할 버전이 존재한다면 아래의 예시 이미지와 같이
오른쪽 하단에 업데이트할 버전이 있다고 작은 팝업이 출력된다.
'Update...'를 누르면 화면 정중앙에 업데이트 팝업이 다시 출력되는데,
'Download' 버튼을 누르면 안드로이드 스튜디오 다운로드 페이지로 이동된다.
새로운 버전의 Android Studio를 다운로드를 한 후 재설치를 진행하면 된다.
당연한 이야기이지만, 안드로이드 스튜디오를 재설치할 때에는
실행되어 있는 안드로이드 스튜디오는 종료한 뒤 재설치해주어야 한다.
그레이들 버전 업데이트
프로젝트에서 프로젝트를 담당하는 "build.gradle(Project: xxx)" 파일을 열자.
그러면 의존성을 주입하는 곳에 그레이들 버전을 입력하는 곳(com.android.tools.build:gradle)이 보일 것이다.
현재 요구하는 API 34의 최소 그레이들 버전은 8.1.1이므로, 나는 8.1.1을 해주었다.
물론 그 이상의 버전을 선택해도 된다.
buildscript {
repositories {
google()
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:8.1.1' // 8.0.2에서 8.1.1로 업데이트
classpath 'com.google.gms:google-services:4.3.14'
}
}
버전을 변경했으면 우측 상단의 'Sync Now'를 눌러 해당 프로젝트에 적용될 수 있도록 해준다.