[Android/Gradle] Launch Android SDK Upgrade Assistant 경고 해결 방법

회사에서 업무를 보거나 개인 프로젝트를 위해 프로젝트를 생성할 때, 그동안 무심코 지나쳤던 부분을 짚고 넘어가고자 글을 작성하게 됐다.

 

평소에 코드에서 경고가 발생하면, 빠르게 해결하기 위해 단축키로 경고문 권장 사항을 반영했지만, 이번 경고는 코드 수정을 바로 해주는 경고가 아니라서 내용을 직접 확인해보고자 했다.

 

사실, 단축키로 코드 수정이 가능한 경고라도 내용을 확인하며 짚고 넘어가는 습관을 들이는 것이 좋다..ㅎㅎ

---

Launch Android SDK Upgrade Assistant

경고 발생 원인 코드

사진과 같이 아래 코드에서 경고를 의미하는 노란줄이 표시된다.

• targetSdk = 34

 

경고문은 Launch Android SDK Upgrade Assistant, 직역하면 Android SDK 업그레이드 도우미를 실행한다는 말이다.

위 경고문을 클릭하면 아래와같이 Assistant - Android SDK Upgrade Assistant Tool Window가 뜬다.

---

Assistant - Android SDK Upgrade Assistant 

Android SDK Upgrade Assistant

Android SDK Upgrade Assistant Starting August 31, 2023, all apps (except for Wear OS) must target Android 13 (API level 33) or higher in order to be submitted to Google Play for review and remain discoverable by all Google Play users. Wear OS apps must target Android 11 (API level 30) as of November 1, 2022. This panel describes the major breaking changes and steps required to upgrade targetSdkVersion. Configuring your app to target a recent API level ensures that users can benefit from security and performance improvements, while still allowing an app to run on older Android versions (down to the specified minSdkVersion). Learn more about meeting Google Play's target API level requirement. For a more comprehensive list of version changes, see the Android releases.  To open this panel again later, select Tools > Android SDK Upgrade Assistant.

 

요약하자면 특정기간 이후로 Wear OS를 제외한 모든 앱은 Android 13(API 33) 이상을 타겟팅해야 Google Play에 제출되거나 모든 Google Play 사용자가 검색할 수 있다고한다. (Wear OS 앱은 특정기간 이후로 Android 11(API 30) 타겟팅 해야함)

 

그런데, Android Studio에서 앱 배포를 위한 최소 타겟팅 버전을 Android 13(API 33) 라고 설명했지만,

현재 Google Play에 앱을 올리려면 Android 14(API 34) 이상 타겟팅해야 한다.

(아마도 내가 Android Studio를 업데이트하지 않아서 이전 정보가 표시되고 있는 것일 수도 있음)

 

Android SDK Upgrade Assistant - Pick an upgrade path에서 Android 버전 간 변경사항 및 효율적인 마이그레이션 전략에 대한 내용을 확인할 수 있다.

---

경고 해결 방법

targetSdk을 34로 지정하므로써 경고가 발생한 이유는 최신 SDK가 35이기 때문이다.

즉, targetSdk를 35로 변경하는 것을 권고하고 있다.

 

그러므로 targetSdk = 35, compileSdk = 35로 적용하면 경고 표시가 사라진다.

 

이 경고가 에러가 아닌 경고로 표시되는 이유는, 현재 시점에서는 SDK 35 적용이 필수가 아니며 권장사항에 해당되기 때문이다.

---

특정 SDK가 필수사항으로 변경될 경우

SDK 35 적용이 필수사항으로 변경되면, targetSdk를 34로 설정한 상태에서는 빌드 시 실패하게 된다.

이 경우, Google Play 요구사항을 충족하기 위해 targetSdk와 compileSdk를 35로 업데이트해야 한다.

---

SDK 업데이트 시 고려사항

SDK 업데이트에 영향이 있는 범위는 아래와 같으니, 해당 사항들을 고려하여 적용하고 테스트해야 한다.

1. 앱 동작: 권한, 백그라운드 작업, UI 변화
2. 호환성: 최소 Android 버전 및 라이브러리 지원 여부
3. 빌드 환경: Gradle, 플러그인 업데이트 필요
4. 배포: Google Play 요구사항 충족