이번 편의 목표: Android Studio에서 API 37 플랫폼과 빌드 도구 37을 설치합니다.

안드로이드 17 SDK는 너무 오래된 스튜디오와 맞지 않습니다. 2026년 10월 16일 기준 공식 안내의 하한은 Android Studio Meerkat 2024.3.1입니다. 그 버전 이상을 설치한 뒤 SDK를 받습니다.

스튜디오에서 Tools, SDK Manager를 엽니다. SDK Platforms 탭에서 Android Cinnamon Bun 항목을 펼치고 Android SDK Platform Cinnamon Bun 패키지를 선택합니다. 안드로이드 17의 플랫폼 패키지가 문서에 이 이름으로 안내되어 있습니다. SDK Tools 탭에서는 Android SDK Build-Tools 37 아래의 가장 높은 37.x.x를 선택합니다. OK로 설치합니다.

실행해서 볼 시스템 이미지도 같은 관리자에서 받습니다. 픽셀이 있으면 안드로이드 17 정식 빌드를 기기에 두고, 기기가 없으면 스튜디오의 안드로이드 에뮬레이터용 64비트 시스템 이미지를 사용합니다. 2026년 6월 발표 이후 QPR 베타 이미지가 분기마다 올라오므로, 호환 테스트에는 정식 릴리스 이미지를 먼저 쓰고 베타 이미지는 그 다음으로 둡니다.

설치가 끝나면 스튜디오의 SDK 위치에서 platforms 안에 android-37 디렉터리가 생겨야 합니다. 빌드 도구 디렉터리에는 37로 시작하는 버전이 있어야 합니다. 이 두 가지가 없으면 다음 편의 compileSdk 37은 컴파일에 실패합니다.

설정 안내 원문은 여기에 있습니다.

외부 출처developer.android.comhttps://developer.android.com/about/versions/17/setup-sdk링크 열기

직접 해 보기

SDK Manager를 닫았다가 다시 열어, 방금 선택한 플랫폼과 Build-Tools 37에 설치 표시가 남아 있는지 확인하세요.

해설

플랫폼 패키지는 안드로이드 17 API를 컴파일할 때 필요하고, 시스템 이미지는 그 API로 만든 앱을 실행할 때 필요합니다. 둘 중 하나만 설치하면 빌드 또는 실행 중 한쪽이 비어 있습니다.