Android Gradle 插件 9.1.0（2026 年 3 月）

Android Gradle 插件 9.1 是一个次要版本，包含各种新功能和改进。

兼容性

Android Gradle 插件 9.1 支持的最高 API 级别为 API 级别 36.1。以下是更多兼容性信息：

最低版本 默认版本 备注
Gradle 9.3.1 9.3.1 如需了解详情，请参阅更新 Gradle。
SDK Build Tools 36.0.0 36.0.0 安装或配置 SDK Build Tools。
NDK 不适用 28.2.13676358 安装或配置其他版本的 NDK。
JDK 17 17 如需了解详情，请参阅设置 JDK 版本。

R8 变更

AGP 9.1.0 中包含以下 R8 变更。

在编译为 DEX 时，启用重新打包到未命名（默认）软件包

现在，R8 在默认情况下编译为 DEX 时，会将类重新打包到未命名的（默认）软件包中。这实际上会将规则 -repackageclasses 添加到未使用 -flattenpackagehierarchy 或 -repackageclasses 的 build 中。

默认情况下，重新打包可确保与混淆、优化和缩小保持一致，这些功能都是选择停用而非选择启用，从而缓解未明确选择启用重新打包的次优配置。

如需选择不采用此行为，请使用新的 -dontrepackage 规则。

为 -maximumremovedandroidloglevel 支持了命名级别

使用 -maximumremovedandroidloglevel 时，您现在可以指定日志级别名称，而不是数字。下表显示了名称和对应的数字日志级别。

名称 等级
ASSERT 7
ERROR 6
WARN 5
INFO 4
DEBUG 3
VERBOSE 2
NONE 1

您必须以全大写形式指定日志级别名称。

修复的问题

Android Gradle 插件 9.1.0-rc01

已修复的问题
在 AGP 9.1.0-rc01 中，没有公开问题被标记为已修复

Android Gradle 插件 9.1.0-alpha09

已修复的问题
lint
Otter.2 中的 Lint 无法识别 AGP 9.0 中的新 compileSdk 和 targetSdk DSL

Android Gradle 插件 9.1.0-alpha08

已修复的问题
Android Gradle 插件
“Clean Project”菜单运行的是子项目目标，而不仅仅是“clean”
AGP 中的增量 dex 脱糖 bug
配置缓存：避免在执行时访问任务扩展和惯例
AGP 不了解 Canary 平台并发出抱怨
lint 集成
当应用于 java-library 项目时，Android Lint 使用 K1
“针对 lint 检查的 lint 检查”未运行

Android Gradle 插件 9.1.0-alpha07

已修复的问题
Android Gradle 插件
需要实现 KMP 的 beforeVariants。

Android Gradle 插件 9.1.0-alpha06

已修复的问题
AGP 9.1.0-alpha06 中没有公开问题被标记为已修复

Android Gradle 插件 9.1.0-alpha05

已修复的问题
Android Gradle 插件
AGP 9.0.0-rc01 不会通过 kotlin() 函数解析 Kotlin 库

Android Gradle 插件 9.1.0-alpha04

已修复的问题
Android Gradle 插件
`*.xml.flat` 文件包含绝对文件路径

Android Gradle 插件 9.1.0-alpha03

已修复的问题
AGP 9.1.0-alpha03 中没有公开问题被标记为已修复

Android Gradle 插件 9.1.0-alpha02

已修复的问题
Android Gradle 插件
添加了将 ManifestProcessorTask 警告转换为错误的功能

Android Gradle 插件 9.1.0-alpha01

已修复的问题
Android Gradle 插件
添加了将 ManifestProcessorTask 警告转换为错误的功能
转换 `OBFUSCATION_MAPPING_FILE` 制品会导致 R8 任务的输出从输出文件夹中消失

Android Gradle 插件 9.1.0

已修复的问题
在 AGP 9.1.0 中，没有公开问题被标记为已修复