Android 스튜디오는 Android 개발을 위한 공식 IDE로, Android 앱을 빌드하는 데 필요한 모든 것을 포함하고 있습니다.
이 페이지에는 안정화 버전 채널인 Android 스튜디오 Narwhal 3 기능 출시 최신 버전의 새로운 기능과 개선사항을 소개합니다. 여기에서 다운로드하거나 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 3 기능 출시 | 2025.1.3 | 4.0~8.13 |
| 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 스튜디오 버전 | 필요한 AGP 버전 |
|---|---|
| Electric Eel | 2022.1.1 | 3.2~7.4 |
| Dolphin | 2021.3.1 | 3.2~7.3 |
| Chipmunk | 2021.2.1 | 3.2~7.2 |
| Bumblebee | 2021.1.1 | 3.2~7.1 |
| Arctic Fox | 2020.3.1 | 3.1~7.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 기능 출시부터 시작됩니다.
스튜디오 실험실
스튜디오 Labs를 사용하면 안정적인 버전의 Android 스튜디오에서 최신 AI 실험 기능을 사용해 볼 수 있으므로 개발 워크플로에 Google의 AI 지원 기능을 더 빠르게 통합할 수 있습니다. 자세한 내용은 Studio Labs를 참고하세요.
다음은 현재 스튜디오 Labs에서 사용할 수 있는 기능입니다.
| 기능 | 설명 | 문서 |
|---|---|---|
| Compose 미리보기 생성 | Gemini는 파일의 특정 컴포저블 또는 모든 컴포저블에 대해 미리보기 매개변수의 모의 데이터를 포함한 Compose 미리보기를 자동으로 생성할 수 있습니다. | Compose 미리보기 생성 |
| UI 변환 | 자연어를 사용하여 Compose 미리보기 패널에서 직접 앱 UI를 업데이트합니다. | UI 변환 |
다음은 Android 스튜디오 Narwhal 3 기능 출시의 새로운 기능입니다.
크기 조절 가능한 Compose 미리보기
이제 Compose 미리보기에서 동적 크기 조정을 지원하므로 UI가 다양한 화면 크기에 어떻게 적응하는지 시각적으로 즉시 확인할 수 있습니다.
이 기능을 사용하려면 툴바에서 보기 옵션을 변경하여 Compose 미리보기에서 포커스 모드를 입력하세요.
이제 가장자리를 드래그하여 미리보기 창의 크기를 조절할 수 있습니다.
또는 미리보기 크기를 조절한 후에 표시되는 크기 조절 툴바를 사용할 수 있습니다.
새 크기를 새 Preview 주석으로 저장하려면 마우스 오른쪽 버튼 클릭 메뉴를 사용하세요.
동적 크기 조절 기능을 사용하면 모든 화면 크기에서 멋지게 보이는 UI를 만들 수 있습니다.
해당 모듈 아래에 빌드 파일을 표시하는 Android 뷰 설정
Android 뷰에서 해당 모듈 아래에 빌드 파일을 표시하는 새로운 설정이 있습니다. 이 뷰는 모듈이 많은 프로젝트를 작업할 때 유용합니다. 뷰를 사용 설정하려면 Android 뷰 옆에 있는 옵션
메뉴를 엽니다.
그런 다음 Appearance > Display Build Files In Module을 선택합니다.
Android 스튜디오의 Google Play 정책 통계
이제 Android 스튜디오에 앱에 영향을 미칠 수 있는 Google Play 정책에 관한 풍부한 인사이트와 안내가 포함됩니다. 이 정보를 통해 처음부터 더 안전한 앱을 빌드하여 출시 프로세스를 방해하고 나중에 더 많은 시간과 리소스를 들여 수정해야 하는 문제를 예방할 수 있습니다.
Android 스튜디오 Narwhal 3 기능 출시부터 Google Play 정책 통계를 린트 검사로 확인할 수 있습니다. 이러한 린트 검사에서는 다음 정보를 제공합니다.
- 정책 개요입니다.
- 자주 발생하는 문제를 피하기 위한 권장사항과 주의사항
- 공식 정책과 유용한 정보 및 리소스를 확인할 수 있는 Play 정책 페이지로 연결되는 링크
이 기능은 앱 제출 환경을 원활하게 할 수 있도록 유용한 사전 검토 가이드를 제공하기 위한 것입니다. 모든 정책을 다루지 않으며 최종 앱 검토 결정을 제공하지 않습니다. 자세한 내용은 정책 센터에서 전체 정책을 검토하세요. 또한 이 통합을 적극적으로 발전시키고 개선하고 있습니다. 의견이 있으면 신고해 주세요.
프로젝트에 Play 정책 통계가 있는지 확인하려면 코드 > Play 정책 통계 검사…로 이동하세요. 통계는 '문제' 도구 창에 나열되며 해당 파일에 린트 경고로도 표시됩니다.
앱 백업 및 복원으로 테스트 및 개발
Android 백업 및 복원이 앱에서 제대로 작동하도록 하는 것은 사용자가 새 기기로 전환하거나 클라우드에서 복원한 후에도 앱에 계속 참여하도록 하는 데 매우 중요합니다. 하지만 앱에서 데이터 백업 및 복원이 작동하는지 테스트하기는 어려울 수 있습니다.
Android 스튜디오 Narwhal 3 기능 드롭에서는 앱의 백업을 생성하고 다른 기기에 복원하는 방법을 제공합니다. 이는 기기 간 또는 클라우드 백업에서 앱 데이터를 복원할 때 앱이 예상대로 작동하는지 테스트하거나 앱을 개발하고 디버그하는 데 필요한 데이터로 테스트 기기를 더 빠르게 설정하려는 경우에 유용합니다.
백업 생성
백업 파일을 생성하려면 다음 단계를 따르세요.
- 연결된 기기에 앱의 디버그 버전 배포
- 다음 작업 중 하나를 사용하여 백업을 생성합니다.
- 실행 중인 기기 창에서 툴바의 앱 데이터 백업 작업을 클릭합니다.
- 기본 메뉴 바에서 Run > Backup App Data를 선택합니다.
- 기기 탐색기 > 프로세스 탭에서 앱 프로세스를 마우스 오른쪽 버튼으로 클릭하고 앱 데이터 백업을 선택합니다.
- 대화상자가 나타나면 다음을 수행합니다.
- 백업을 생성할 앱의 애플리케이션 ID를 확인합니다.
- 기기 간, 클라우드 또는 클라우드 (암호화되지 않음) 백업을 생성할지 선택합니다.
- 저장할 백업의 이름과 위치를 확인합니다. 기본적으로 백업은 현재 Android 스튜디오 프로젝트의 루트 디렉터리에 저장됩니다.
앱의 백업을 생성합니다.
- 백업을 생성할 앱의 애플리케이션 ID를 확인합니다.
- Android 스튜디오에서 앱을 중지할 수 있는지 묻는 메시지가 표시되면 확인을 클릭합니다. 백업을 생성하려면 Android 스튜디오에서 앱 프로세스를 중지해야 합니다.
프로젝트 > Android 도구 창의 백업 파일 노드에서 생성한 백업을 볼 수 있습니다.
백업 유형
앱의 다양한 유형의 백업을 생성할 수 있습니다. 백업을 생성할 때 테스트하려는 시나리오와 관련된 백업 유형을 선택하세요.
- 기기 간: 기기 간 전송 중에 생성된 백업과 유사한 앱 백업을 생성합니다. 기기 간 전송에서는 앱의 백업 데이터가 USB나 Wi-Fi 등을 통해 다른 기기로 직접 전송됩니다.
- 클라우드: 사용자의 Google 계정 스토리지에 저장된 것과 유사한 앱의 백업을 생성합니다. 사용자가 새 기기를 설정할 때 클라우드 백업에서 복원하도록 선택할 수 있습니다.
- 클라우드 (암호화되지 않음): 클라이언트 측 암호화가 사용 설정되지 않은 기기에서 사용자의 Google 계정 저장소에 저장된 것과 유사한 앱 백업을 생성합니다.
참고: 이 기능을 사용하여 클라우드, 클라우드 (암호화되지 않음) 또는 기기 간 백업을 테스트하는 경우 실제 백업 흐름과 달리 생성된 백업이 클라우드나 다른 기기로 전송되지 않습니다. 앱이 클라우드에 저장되거나 다른 기기로 전송되는 것처럼 앱의 백업을 생성합니다. 모든 백업 유형에 대해 생성된 백업은 프로젝트 > Android 도구 창의 백업 파일에 있을 수 있습니다.
앱 데이터 복원
앱 데이터를 복원하려면 다음 단계를 따르세요.
- 연결된 기기에 앱을 배포합니다. 앱의 애플리케이션 ID는 기기에 복원하려는 백업 파일과 동일해야 합니다.
- 다음 작업 중 하나로 이동하여 클릭합니다.
- Running Device 창에서 툴바의 Restore App Data 작업을 클릭하고 최근 기록에서 백업 파일을 선택하거나 Browse를 클릭합니다.
- 기본 메뉴 바에서 Run > Restore App Data로 이동합니다.
- 기기 탐색기 > 프로세스 탭에서 앱 프로세스를 마우스 오른쪽 버튼으로 클릭하고 앱 데이터 복원을 선택합니다.
- Project > Android 도구 창에서 Backup Files 노드 아래의 백업을 마우스 오른쪽 버튼으로 클릭하고 Restore App Data를 선택합니다.
- 해당하는 경우 최근 기록에서 백업을 선택하거나 찾아보기를 클릭하여 로컬 저장소에서 복원할 백업 파일을 선택합니다.
또는 실행 구성의 일부로 백업 파일을 포함하여 앱을 배포할 때 백업 파일에서 앱 데이터를 복원할 수도 있습니다. 이렇게 하려면 다음을 실행하세요.
- 기본 메뉴 바에서 Run > Edit Configurations로 이동합니다.
- 앱 실행 구성을 선택하고 복원 옵션으로 이동합니다.
실행 구성에서 옵션을 복원합니다. - 백업에서 앱을 복원하려면 앱 상태 복원 옆의 체크박스를 선택합니다.
- 최근 기록에서 백업 파일을 선택하거나 로컬 저장소에서 백업 파일을 찾아 선택합니다.
- 새 앱 설치 시에만 앱 데이터를 복원하려면 새 APK 설치 시에만 복원 옆의 체크박스를 선택합니다. 이 옵션은 새 테스트 기기에 배포하고 디버깅 및 앱 개발에 도움이 되도록 데이터를 복원하려는 경우에 유용합니다.
- OK를 클릭하여 실행 구성을 저장합니다.
- 실행 구성을 사용하여 앱을 배포하여 연결된 기기에 앱 데이터를 복원하는 것을 테스트합니다.
Proguard 검사
이제 Android 스튜디오에는 잘못 작성된 ProGuard 규칙이나 R8 최적화를 방지하는 규칙을 방지하는 검사가 포함됩니다. -keep class **.*와 같은 지나치게 광범위한 유지 규칙과 dontshrink, -dontoptimize와 같은 소비자 Proguard 규칙 구성은 이제 Studio IDE에서 경고를 트리거합니다. 코드 축소를 허용하는 적절한 keep 규칙을 만들려면 규칙의 범위를 특정 패키지로 지정하고 유지하려는 항목을 명시적으로 지정하세요.
프로젝트 수준 컨텍스트의 AGENT.md 파일
이제 프로젝트에 AGENT.md 파일을 포함할 수 있습니다. 이러한 파일은 프로젝트별 안내, 코딩 스타일 규칙, 기타 지침을 Gemini에 컨텍스트로 제공하는 Markdown 파일입니다.
Gemini는 프로젝트에서 AGENT.md라는 이름의 파일에 있는 요청 사항을 자동으로 검색하고 적용합니다. AGENT.md 파일이 없으면 Gemini는 대신 GEMINI.md 파일을 대체로 찾습니다.
자동 동기화를 사용 중지하는 새로운 설정
이제 Android 스튜디오에서 기본 자동 동기화 모드 (예: 프로젝트를 열 때 동기화가 자동으로 실행됨)에서 알림이 있는 새로운 수동 동기화 모드로 전환하는 설정을 제공합니다. 기본 동작은 여전히 자동 동기화입니다. 수동 동기화로 전환하려면 File (macOS의 경우 Android 스튜디오) > Settings > Build, Execution, Deployment > Build Tools로 이동하여 Project Sync mode를 Manual Sync with reminders로 설정합니다.
Gemini의 이미지 첨부파일
이제 이미지 파일을 첨부하고 프롬프트와 함께 추가 정보를 제공할 수 있습니다. 예를 들어 UI 모형이나 스크린샷을 첨부하여 Gemini에게 앱의 레이아웃에 관한 컨텍스트를 제공할 수 있습니다. 따라서 Gemini는 제공된 이미지를 기반으로 Compose 코드를 생성하거나 UI 스크린샷의 컴포저블과 데이터 흐름을 설명할 수 있습니다. 자세한 내용은 질문에 이미지 첨부하기를 참고하세요.
Gemini의 @파일 컨텍스트
이제 Android 스튜디오에서 Gemini와의 채팅 상호작용에 프로젝트 파일을 컨텍스트로 첨부할 수 있습니다. 이렇게 하면 Gemini 프롬프트에서 파일을 빠르게 참조할 수 있습니다. Gemini 채팅 입력란에 @를 입력하여 파일 자동 완성 메뉴를 표시하고 첨부할 파일을 선택합니다. 컨텍스트 드롭다운을 클릭하여 Gemini가 자동으로 첨부한 파일을 확인할 수도 있습니다. 이렇게 하면 Gemini에 전송되는 컨텍스트를 더 효과적으로 제어할 수 있습니다. 자세한 내용은 질문에 파일 첨부하기를 참고하세요.
