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 Build Tools 36.0.0 36.0.0 安装或配置 SDK Build Tools。
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 build 变种维度对等性，并将所有缺失、多余或不匹配的维度报告为 build 警告。为了帮助您为更严格的验证做好准备，同时又不破坏现有的 build 流水线，此检查默认以警告模式运行，但可以通过启用 android.enforceDynamicFeatureVariantMatching=true Gradle 选项将其升级为执行错误。从 AGP 10.0 开始，系统将默认强制执行严格的 1:1 变体对等性，将基础应用及其动态功能模块之间的所有维度不匹配情况都转化为致命的 build 失败。

修复的问题

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 过度热切