Android Gradle 플러그인 9.4.0 (2026년 9월)

Android Gradle 플러그인 9.4는 다양한 새 기능과 개선사항이 포함된 마이너 버전입니다.

호환성

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

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

Variant API 모듈 선택 해제

AGP 10부터는 모든 프로젝트에 새 Variant API가 필수입니다. 점진적인 이전을 지원하려면 AGP 10 이전에 gradle.properties 파일에 다음을 적용하여 특정 모듈을 이 요구사항에서 일시적으로 선택 해제할 수 있습니다.

android.newDsl.optOut=:example-lib1

동적 기능과 Android 앱 간의 엄격한 1:1 변형 패리티

AGP 9.4부터 빌드 시스템은 Android 앱 모듈과 동적 기능 모듈 간의 엄격한 1:1 flavor 측정기준 패리티를 확인하여 누락되거나 추가되거나 일치하지 않는 측정기준을 빌드 경고로 보고합니다. 기존 빌드 파이프라인을 중단하지 않고 더 엄격한 유효성 검사를 준비할 수 있도록 이 검사는 기본적으로 경고 모드로 작동하지만 android.enforceDynamicFeatureVariantMatching=true Gradle 옵션을 사용 설정하여 실행 오류로 승격할 수 있습니다. AGP 10.0부터는 엄격한 1:1 변형 패리티가 기본적으로 적용되어 기본 앱과 동적 기능 모듈 간의 모든 측정기준 불일치가 치명적인 빌드 실패로 이어집니다.

해결된 문제

Android Gradle 플러그인 9.4.0-alpha04

해결된 문제
AGP 9.4.0-alpha04에서 해결된 것으로 표시된 공개 문제는 없습니다.

Android Gradle 플러그인 9.4.0-alpha03

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

Android Gradle 플러그인 9.4.0-alpha02

해결된 문제
Android Gradle 플러그인
AGP SigningConfig가 너무 적극적임
동적 기능 모듈에 정의된 제공자로 `./gradlew :app:connectedDebugAndroidTest` 를 실행할 때 'Unable to get provider' (ClassNotFoundException) 발생

Android Gradle 플러그인 9.4.0-alpha01

해결된 문제
Android Gradle 플러그인
AGP SigningConfig가 너무 적극적임