Android Gradle 플러그인 9.3.0 (2026년 7월)

Android Gradle 플러그인 9.3은 다양한 새 기능과 개선사항이 포함된 부 버전입니다.

호환성

Android Gradle 플러그인 9.3에서 지원하는 최대 API 수준은 API 수준 37입니다. 다음은 기타 호환성 정보입니다.

최소 버전 기본 버전 참고
Gradle 9.5.0 9.5.0 자세한 내용은 Gradle 업데이트하기를 참고하세요.
SDK 빌드 도구 36.0.0 36.0.0 설치 또는 구성 SDK 빌드 도구.
NDK 해당 사항 없음 28.2.13676358 다른 버전의 NDK를설치 또는 구성합니다.
JDK 17 17 자세한 내용은 JDK 버전 설정을 참고하세요.

독립형 R8 구성 분석기 Gradle 작업

Android Gradle 플러그인 9.3에서는 R8 구성 분석기를 격리된 상태로 실행하기 위한 전용 Gradle 작업을 도입합니다. R8 구성 분석기는 앱의 코드 축소 및 난독화 규칙을 최적화하는 데 도움이 됩니다.

./gradlew :app:analyzeReleaseR8Config

:app:analyzeReleaseR8Config 작업은 APK 또는 번들 컴파일 파이프라인을 완료하지 않고 보고서를 생성합니다. 이렇게 하면 피드백 루프가 단축되어 유지 규칙을 세부 조정할 때 개발자 반복이 빨라집니다. 또는 R8 출시 빌드 (예: assembleRelease 또는 bundleRelease)를 실행하여 보고서를 자동으로 생성할 수 있습니다.

자세한 내용은 보고서 생성을 위한 독립형 Gradle 작업 실행 을 참고하세요.

해결된 문제

Android Gradle 플러그인 9.3.0-rc02

해결된 문제
AGP 9.3.0-rc02에서 해결됨으로 표시된 공개 문제가 없습니다.

Android Gradle 플러그인 9.3.0-rc01

해결된 문제
AGP 9.3.0-rc01에서 해결됨으로 표시된 공개 문제가 없습니다.

Android Gradle 플러그인 9.3.0-alpha12

해결된 문제
Android Gradle 플러그인
빌드 실패: compile_library_classes_jar의 classes.jar에서 파일 핸들 누출로 인해 IDE를 다시 시작할 때까지 Windows에서 재빌드할 수 없음
린트
린트가 가져온 Java 라이브러리를 Android 프로젝트로 처리하여 컴파일 SDK 버전을 무시함

Android Gradle 플러그인 9.3.0-alpha11

해결된 문제
AGP 9.3.0-alpha11에서 해결됨으로 표시된 공개 문제가 없습니다.

Android Gradle 플러그인 9.3.0-alpha10

해결된 문제
AGP 9.3.0-alpha10에서 해결됨으로 표시된 공개 문제가 없습니다.

Android Gradle 플러그인 9.3.0-alpha09

해결된 문제
AGP 9.3.0-alpha09에서 해결됨으로 표시된 공개 문제가 없습니다.

Android Gradle 플러그인 9.3.0-alpha08

해결된 문제
AGP 9.3.0-alpha08에서 해결됨으로 표시된 공개 문제가 없습니다.

Android Gradle 플러그인 9.3.0-alpha07

해결된 문제
AGP 9.3.0-alpha07에서 해결됨으로 표시된 공개 문제가 없습니다.

Android Gradle 플러그인 9.3.0-alpha06

해결된 문제
Android Gradle 플러그인
JavaDocGenerationTask에서 작업자를 사용해야 함

Android Gradle 플러그인 9.3.0-alpha05

해결된 문제
축소기 (R8)
L8 난독화 매핑이 앱 mapping.txt에 포함되지 않음

Android Gradle 플러그인 9.3.0-alpha04

해결된 문제
Android Gradle 플러그인
KMP keepRules 소스 세트가 it.consumerKeepRules.publish = true 없이 무시됨

Android Gradle 플러그인 9.3.0-alpha03

해결된 문제
Android Gradle 플러그인
java.lang.ClassNotFoundException: Gradle을 9.2.0으로 업그레이드한 후 'com.android.tools.r8.RecordTag' 클래스를 찾지 못함
린트
리소스 축소가 사용 중지된 경우 린트 오류 발생

Android Gradle 플러그인 9.3.0-alpha02

해결된 문제
Android Gradle 플러그인
기능 요청: Android Gradle 플러그인에 native_libs_merge_blame_file 지원 추가
린트
AnnotationDetector 문제 메시지에 백틱 누락
리소스 축소가 사용 중지된 경우 린트 오류 발생

Android Gradle 플러그인 9.3.0-alpha01

해결된 문제
Android Gradle 플러그인
자동 생성된 버전 코드 관련 문제
AGP: 종속 항목 표기법으로 프로젝트에서 이전
린트
UseKtx를 사용한 린트 거짓양성

Android Gradle 플러그인 9.3.0

해결된 문제
AGP 9.3.0에서 해결됨으로 표시된 공개 문제가 없습니다.

R8 유지 규칙을 구성하도록 최적화 DSL 업데이트

앱 모듈 및 라이브러리 모듈 테스트에서 지원하는 R8 최적화의 유지 규칙을 구성하기 위해 업데이트된 최적화 DSL을 도입합니다. 업데이트된 DSL로 최적화를 구성하려면 새 optimization 블록을 사용하세요. 앱의 경우 앱 수준 빌드 스크립트의 빌드 유형 (예: release 또는 debug) 내에서 optimization 블록을 구성합니다. 업데이트된 최적화 DSL을 사용하면 R8 구성이 더 간단해집니다.

  • 최적화를 사용 설정하면 코드 최적화와 최적화된 리소스 축소가 모두 사용 설정됩니다.
  • 더 이상 기본 Android 유지 규칙 파일을 지정할 필요가 없습니다.

레거시 DSL은 계속 지원됩니다.

유지 규칙을 정의하기 위한 소스 세트 도입

파일 접미사 .keep을 사용하여 유지 규칙을 src/<variant>/keepRules/ 소스 세트에 배치합니다. 유지 규칙의 소스 세트는 업데이트된 최적화 DSL과 레거시 DSL에서 지원됩니다. 유지 규칙의 소스 세트 사용은 앱 모듈, 라이브러리 모듈에서 지원되며 Kotlin 멀티플랫폼 (KMP) 모듈에서 소비자 규칙을 정의하는 방법으로 지원됩니다.