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 버전 차원 패리티를 확인하고 누락되거나 추가되거나 일치하지 않는 차원을 빌드 경고로 보고합니다. 기존 빌드 파이프라인을 중단하지 않고 더 엄격한 유효성 검사를 준비할 수 있도록 이 검사는 기본적으로 경고 모드로 작동하지만 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` 를 실행할 때 '제공업체를 가져올 수 없음'(ClassNotFoundException) 오류 발생

Android Gradle 플러그인 9.4.0-alpha01

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