Android Gradle Plugin 8.1.0（2023 年 7 月）

Android Gradle plugin 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 plugin 会根据您的项目资源生成 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
    }
  }
}

实验性构建标志

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

已解决的问题

Android Gradle plugin 8.1.0

Android Gradle plugin 8.1.1

Android Gradle plugin 8.1.2

Android Gradle plugin 8.1.3

Android Gradle plugin 8.1.4