Android 스튜디오 Narwhal 기능 출시 | 2025.1.2

Android 스튜디오는 Android 개발을 위한 공식 IDE로, Android 앱을 빌드하는 데 필요한 모든 것을 포함하고 있습니다.

이 페이지에는 안정화 버전 채널인 Android 스튜디오 Narwhal 기능 출시 최신 버전의 새로운 기능과 개선사항을 소개합니다. 여기에서 다운로드하거나 Help > Check for updates(macOS는 Android Studio > Check for updates)를 클릭하여 Android 스튜디오 내에서 업데이트할 수 있습니다.

Android 스튜디오의 안정화 버전입니다. 패치에는 새로운 사소한 기능과 버그 수정이 포함될 수 있습니다. Android 스튜디오 버전 이름 지정에 관해 알아보려면 Android 스튜디오 출시 이름을 참고하세요.

이 버전의 Android 스튜디오에서 수정된 사항을 확인하려면 해결된 문제를 참고하세요.

이전 버전의 Android 스튜디오 출시 노트를 보려면 이전 출시를 참고하세요.

출시될 기능 및 개선사항의 사전 체험판은 Android 스튜디오의 미리보기 빌드를 참고하세요.

Android 스튜디오에 문제가 발생하면 알려진 문제 또는 문제 해결 페이지를 확인하세요.

Android Gradle 플러그인과 Android 스튜디오 호환성

Android 스튜디오 빌드 시스템은 Gradle을 기반으로 하며 Android Gradle 플러그인(AGP)에는 Android 앱을 빌드하는 데 사용하는 몇 가지 추가 기능이 있습니다. 다음 표에는 각 버전의 Android 스튜디오에 필요한 AGP 버전이 나열되어 있습니다.

Android 스튜디오 버전	필요한 AGP 버전
Narwhal 기능 출시 | 2025.1.2	4.0~8.12
Narwhal | 2025.1.1	3.2~8.11
Meerkat 기능 출시 | 2024.3.2	3.2~8.10
Meerkat | 2024.3.1	3.2~8.9
Ladybug 기능 출시 | 2024.2.2	3.2~8.8
Ladybug | 2024.2.1	3.2~8.7
Koala 기능 출시 | 2024.1.2	3.2~8.6
Koala | 2024.1.1	3.2~8.5
Jellyfish | 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

Android Gradle 플러그인의 새로운 기능에 관한 정보는 Android Gradle 플러그인 출시 노트를 참고하세요.

Android API 수준 도구 최소 버전

특정 API 수준을 지원하는 최소 버전의 Android 스튜디오와 AGP가 있습니다. 프로젝트의 targetSdk 또는 compileSdk에 필요한 버전보다 낮은 버전의 Android 스튜디오 또는 AGP를 사용하면 예기치 않은 문제가 발생할 수 있습니다. Android OS의 미리보기 버전을 타겟팅하는 프로젝트에서 작업하려면 Android 스튜디오와 AGP의 최신 미리보기 버전을 사용하는 것이 좋습니다. 안정화 버전과 함께 Android 스튜디오의 미리보기 버전을 설치할 수 있습니다.

Android 스튜디오 및 AGP의 최소 버전은 다음과 같습니다.

API 수준	Android 스튜디오 최소 버전	AGP 최소 버전
36.0	Meerkat | 2024.3.1 패치 1	8.9.1
35	Koala 기능 출시 | 2024.2.1	8.6.0
34	Hedgehog | 2023.1.1	8.1.1
33	Flamingo | 2022.2.1	7.2

Android 스튜디오 및 클라우드 서비스 호환성

Android 스튜디오에는 Android 앱을 개발, 출시, 유지관리할 때 개발자와 팀이 더 빠르게 진행할 수 있도록 지원하는 서비스 통합이 포함되어 있습니다. 여기에는 Android 스튜디오의 Gemini, Play Vitals, Firebase Crashlytics와 같은 클라우드 서비스가 포함됩니다. 클라우드 서비스는 Android 스튜디오의 최신 안정화 채널 버전, 가장 최근의 이전 주요 버전 3개, 이러한 버전과 연결된 패치에서만 사용할 수 있습니다. 버전이 호환성 기간을 벗어나면 서비스 통합이 사용 중지되고 Android 스튜디오를 업데이트해야 합니다.

현재 클라우드 서비스와 호환되는 Android 스튜디오 버전

Android 스튜디오 Meerkat 기능 출시의 안정화 버전 채널을 기준으로 모든 버전의 스튜디오가 클라우드 서비스와 호환됩니다. 시행은 Android 스튜디오 Narwhal 기능 출시부터 시작됩니다.

다음은 Android 스튜디오 Narwhal 기능 출시의 새로운 기능입니다.

Android 스튜디오의 에이전트 모드에서 Gemini 사용

Android 스튜디오의 Gemini 에이전트 모드는 Gemini와의 채팅으로 해결할 수 있는 작업보다 더 복잡한 다단계 개발 작업을 처리할 수 있도록 설계된 새로운 AI 기능입니다. 에이전트 모드를 사용하려면 사이드바에서 Gemini를 클릭한 다음 에이전트 탭을 선택합니다. 단위 테스트 생성이나 오류 수정과 같은 복잡한 목표를 설명하면 에이전트가 프로젝트의 여러 파일을 포괄하는 실행 계획을 수립합니다. 에이전트는 목표를 달성하기 위해 수정사항을 제안하고 버그를 반복적으로 수정합니다. 제안된 변경사항을 검토하고 수락 또는 거부할 수 있으며 상담사에게 의견을 반영해 달라고 요청할 수 있습니다.

Gemini의 규칙

Gemini의 규칙을 사용하면 프롬프트 라이브러리 내에서 선호하는 코딩 스타일이나 출력 형식을 정의할 수 있습니다. 선호하는 기술 스택과 언어를 언급할 수도 있습니다. 이러한 환경설정을 한 번 설정하면 Gemini에 전송되는 모든 후속 프롬프트에 자동으로 적용됩니다. 규칙은 AI가 프로젝트 표준과 환경설정을 이해하여 더 정확하고 맞춤설정된 코드 지원을 제공하는 데 도움이 됩니다. 예를 들어 '항상 Kotlin으로 간결한 대답을 제공해 줘'와 같은 규칙을 만들 수 있습니다.

규칙을 설정하려면 Android 스튜디오 > 설정 > 도구 > Gemini > 프롬프트 라이브러리 > 규칙으로 이동하여 편집기에서 텍스트를 수정합니다. 드롭다운을 사용하여 규칙을 IDE 수준 또는 프로젝트 수준에 저장합니다.

• IDE 수준 규칙은 비공개이며 여러 프로젝트에서 사용될 수 있습니다.
• 프로젝트 수준 규칙은 같은 프로젝트에서 작업하는 팀원 간에 공유될 수 있습니다. 팀 전체에서 프롬프트를 공유하려면 .idea 폴더를 버전 제어 시스템에 추가해야 합니다.

삽입된 XR 에뮬레이터

이제 XR 에뮬레이터가 기본적으로 삽입된 상태로 실행됩니다. 이제 Android 스튜디오 내에서 직접 애플리케이션을 배포하고, 3D 공간을 탐색하고, Layout Inspector를 사용할 수 있습니다.

XR 프로젝트 템플릿

Android Narwhal 기능 드롭에서는 Jetpack XR용으로 특별히 설계된 새로운 프로젝트 템플릿을 도입합니다. 이를 통해 몰입형 환경 개발 여정을 바로 시작할 수 있는 상용구 코드를 사용하여 탄탄한 기반을 마련할 수 있습니다.

XR용 삽입된 Layout Inspector

이제 삽입된 Layout Inspector에서 XR 애플리케이션을 지원하므로 XR 환경 내에서 UI 레이아웃을 검사하고 최적화할 수 있습니다. 앱의 구성요소 구조에 대한 세부적인 통계를 확인하고 잠재적인 레이아웃 문제를 파악하여 더 세련되고 성능이 우수한 환경을 만드세요.

16KB 페이지 크기 지원

Android 스튜디오 Narwhal 기능 출시에서는 16KB 페이지 크기로 전환하기 위한 지원이 개선되었습니다. 이 전환을 원활하게 진행할 수 있도록 Android 스튜디오에서는 이제 16KB 기기와 호환되지 않는 APK 또는 Android App Bundle을 빌드할 때 사전 경고를 제공합니다. APK Analyzer를 사용하면 16KB 기기와 호환되지 않는 라이브러리도 확인할 수 있습니다. 이 새로운 환경에서 앱을 테스트할 수 있도록 Android 스튜디오에는 기존 4KB 이미지와 함께 전용 16KB 에뮬레이터 타겟도 제공됩니다.

Gemini로 UI 변환

이제 미리보기에서 직접 자연어를 사용하여 Compose 미리보기 환경 내에서 UI 코드를 변환할 수 있습니다. 이 기능을 사용하려면 Compose 미리보기에서 마우스 오른쪽 버튼을 클릭하고 Gemini로 UI 변환을 선택합니다. 그런 다음 '이 버튼을 가운데 정렬해 줘'와 같은 자연어 요청을 입력하여 Gemini가 레이아웃이나 스타일을 조정하도록 안내하거나 미리보기에서 특정 UI 요소를 선택하여 컨텍스트를 개선합니다. 그러면 Gemini가 Compose UI 코드를 바로 수정하며, 이를 검토하고 승인하여 UI 개발 워크플로를 빠르게 처리할 수 있습니다.

Compose 미리보기 탐색 개선사항

이제 최신 탐색 개선사항을 통해 Compose 미리보기 상호작용이 더욱 효율적입니다. 미리보기 이름을 클릭하여 미리보기 정의로 이동하거나 개별 구성요소를 클릭하여 정의된 함수로 이동합니다. 마우스를 미리보기 프레임 위로 가져가면 즉각적인 시각적 피드백이 제공됩니다. 개선된 키보드 화살표 탐색을 통해 여러 미리보기를 쉽게 이동할 수 있으므로 UI를 더 빠르게 반복하고 개선할 수 있습니다.

Compose 미리보기 선택 도구

이제 Compose 미리보기 선택기를 사용할 수 있습니다. 사용해 보려면 Compose 코드에서 @Preview 주석을 클릭하세요.

Layout Inspector의 하위 리컴포지션

Layout Inspector는 하위 요소 리컴포지션 횟수를 지원합니다. 이제 재구성되는 컴포저블이 구성요소 트리의 상위 요소 아래에 접혀 있어도 재구성 횟수를 확인할 수 있습니다. 하위 리컴포지션 수가 증가하는 것을 확인하면 트리를 열어 리컴포지션이 발생하는 위치를 찾을 수 있습니다.

자동 동기화를 사용 중지하는 새로운 설정

이제 Android 스튜디오에서 기본 자동 동기화 모드 (예: 프로젝트를 열 때 동기화가 자동으로 실행됨)에서 알림이 있는 새로운 수동 동기화 모드로 전환하는 설정을 제공합니다. 기본 동작은 여전히 자동 동기화입니다. 수동 동기화로 전환하려면 File (macOS의 경우 Android 스튜디오) > Settings > Build, Execution, Deployment > Build Tools로 이동하여 Project Sync mode를 Manual Sync with reminders로 설정합니다.

Android 기기 스트리밍에서 사용할 수 있는 파트너 기기 실험실

파트너 기기 연구소는 Samsung, Xiaomi, OPPO, OnePlus, vivo 등 Google OEM 파트너가 운영하는 기기 연구소로, Android 기기 스트리밍에서 사용할 수 있는 기기 선택의 폭을 넓혀 줍니다. 이 서비스는 베타 버전이며 최신 Android 스튜디오 카나리아 버전에서 사용할 수 있습니다. 자세한 내용은 파트너 기기 연구소에 연결을 참고하세요.

기본적으로 K2 모드

이제 Android 스튜디오는 기본적으로 K2 Kotlin 컴파일러를 사용합니다. 이 차세대 컴파일러는 IDE와 빌드의 성능을 크게 향상합니다. K2를 사용 설정하면 향후 Kotlin 프로그래밍 언어 기능과 Kotlin에서 더 빠르고 강력한 개발 환경을 위한 길이 열립니다.