Android Gradle 插件 8.1.0 (2023 年 7 月)

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

兼容性

Kotlin DSL 是构建配置的默认值

新项目现在默认使用 Kotlin DSL (build.gradle.kts) 进行构建配置。与 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 会添加此默认语言环境以及您使用 values-* 目录在 res 文件夹中指定的任何 备用语言环境，到自动生成的 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 升级助手（工具 > AGP 升级助手）。

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

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

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

实验性构建标志

这些是 AGP 8.1 中可用的用于配置构建的实验性标志。

已修复的问题

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