Android Gradle 插件 8.1.0（2023 年 7 月）

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

兼容性

Kotlin DSL 是 build 配置的默认语言

新项目现在默认使用 Kotlin DSL (build.gradle.kts) 进行 build 配置。与 Groovy DSL (build.gradle) 相比，这提供了更好的编辑体验，包括语法突出显示、代码补全和导航到声明。请注意，如果您使用 AGP 8.1 和 Kotlin DSL 进行构建配置，则应使用 Gradle 8.1 以获得最佳体验。如需了解详情，请参阅 Kotlin DSL 迁移指南。

各应用自动设定语言支持

从 Android Studio Giraffe Canary 7 和 AGP 8.1.0-alpha07 开始，您可以将应用配置为自动支持各应用语言偏好设定。Android Gradle 插件会根据您的项目资源生成 LocaleConfig 文件，并在最终清单文件中添加对该文件的引用，这样您就不再需要手动操作。AGP 使用应用模块的 res 文件夹中的资源以及任何库模块依赖项来确定要在 LocaleConfig 文件中添加的语言区域。

请注意，各应用自动语言功能支持搭载 Android 13（API 级别 33）或更高版本的应用。如需使用此功能，您必须将 compileSdkVersion 设为 33 或更高版本。如需为之前版本的 Android 配置各应用语言偏好设定，您仍然需要使用 API 和应用内语言选择器。

如需启用各应用自动设定语言支持，请指定默认语言区域：

1. 在应用模块的 res 文件夹中，创建一个名为 resources.properties 的新文件。

2. 在 resources.properties 文件中，使用 unqualifiedResLocale 标签设置默认语言区域。将语言代码与可选的脚本代码和区域代码（使用短划线将各部分隔开）组合在一起即可构成语言区域名称：

   • 语言：使用由两个或三个字母组成的 ISO 639-1 代码。
   • 脚本（可选）：使用 ISO 15924 代码。
   • 区域（可选）：使用由两个字母组成的 ISO 3166-1-alpha-2 代码或三位数的 UN_M.49 代码。

   例如，如果您的默认语言区域是美式英语：

       unqualifiedResLocale=en-US
       

AGP 会将此默认语言区域和您指定的所有其他语言区域（使用 res 文件夹中的 values-* 目录）添加到自动生成的 LocaleConfig 文件中。

各应用自动设定语言支持功能默认处于关闭状态。如需启用此功能，请使用模块级 build.gradle.kts 文件（如果您使用的是 Groovy，则为 build.gradle 文件）的 androidResources {} 块中的 generateLocaleConfig 设置：

android {
  androidResources {
    generateLocaleConfig = true
  }
}

android {
  androidResources {
    generateLocaleConfig true
  }
}

Android lint 包含以 JVM 17 为目标平台的字节码

从 AGP 8.1.0-alpha04 开始，Android Lint 包含以 JVM 17 为目标平台的字节码。如果您编写自定义 lint 检查，则需要使用 JDK 17 或更高版本进行编译，并在 Kotlin 编译器选项中指定 jvmTarget = '17'。

如需详细了解 lint 工具，请参阅使用 lint 检查改进您的代码。

原生库压缩设置已移至 DSL

从 AGP 8.1.0-alpha10 开始，如果您未使用 DSL（而非清单）配置原生库压缩，则会收到警告。以下指南介绍了如何更新配置以使用 DSL。如需获取进行这些更新方面的帮助，请使用 AGP 升级助理 (Tools > AGP Upgrade Assistant)。

如需使用未压缩的原生库，请从清单中移除 android::extractNativeLibs 属性，并将以下代码添加到模块级 build.gradle.kts 文件（如果您使用的是 Groovy，则为 build.gradle 文件）：

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging = false
    }
  }
}

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

实验性 build 标志

这些是用于配置 AGP 8.1 中提供的 build 的实验性标志。

修复的问题

Android Gradle 插件 8.1.0

Android Gradle 插件 8.1.1

Android Gradle 插件 8.1.2

Android Gradle 插件 8.1.3

Android Gradle 插件 8.1.4