Android Gradle 插件 8.0.0 (2023 年 4 月)

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

兼容性

补丁版本

以下是 Android Gradle 插件 8.0 的补丁版本列表。

Android Gradle 插件 8.0.2 (2023 年 5 月)

如需了解 AGP 8.0.2 中修复的 bug 列表，请参阅 Android Studio 2022.2.1 已关闭的问题。

Android Gradle 插件 8.0.1 (2023 年 5 月)

此小更新包含以下 bug 修复

破坏性变更：模块级构建脚本中需要 namespace

您必须在模块级 build.gradle.kts 文件中设置 namespace，而不是在 manifest 文件中。从 AGP 7.3 开始，您可以使用 namespace DSL 属性。要了解详情，请参阅设置 namespace。

迁移到 namespace DSL 时，请注意以下问题

• 在某些情况下，早期版本的 AGP 会错误地从主 namespace 或应用 ID 推断测试 namespace。如果 AGP Upgrade Assistant 发现您项目的主 namespace 和测试 namespace 相同，则会阻止升级。如果升级被阻止，您需要手动更改 testNamespace 并相应地修改您的源代码。
• 更改测试 namespace 后，您的代码可能会编译成功，但插桩测试在运行时失败。如果您的插桩测试源代码引用了 androidTest 和应用源代码中都定义的资源，就可能发生这种情况。

如需了解详情，请参阅问题 #191813691 评论 #19。

破坏性变更：构建选项默认值

从 AGP 8.0 开始，这些标志的默认值已更改，以提高构建性能。如需获取帮助调整代码以支持其中的某些更改，请使用 AGP Upgrade Assistant（Tools > AGP Upgrade Assistant）。Upgrade Assistant 会指导您更新代码以适应新行为或设置标志以保留以前的行为。

破坏性变更：强制执行的构建选项值

从 AGP 8.0 开始，您无法再更改这些标志的值。如果您在 gradle.properties 文件中指定它们，这些值将被忽略，AGP 会输出警告。

用于执行配置文件的新的稳定标志

AGP 包含新标志 android.settings.executionProfile。使用此标志可以覆盖 SettingsExtension 中的默认执行配置文件。要了解详情，请参阅settings 插件文档。

要预览实验性标志，请参阅预览版发布说明。

不支持 Kotlin 惰性属性赋值

如果您正在为构建脚本使用 Gradle 的 Kotlin DSL，请注意 Android Studio 和 AGP 8.0 不支持使用 = 运算符进行实验性属性赋值。有关此功能的更多信息，请参阅发布说明和文档。

Build Analyzer 任务类别

从 Android Studio Flamingo 开始，Build Analyzer 为影响构建时长的任务提供了新的默认视图。如果您的项目使用 AGP 8.0 或更高版本，Build Analyzer 会按类别对任务进行分组，而不是单独显示。例如，Android Resources、Kotlin 或 Dexing 特定的任务会被分在一起，然后按构建时长排序。这使得用户可以轻松了解哪个类别对构建时间影响最大。展开每个类别会显示相应的任务列表。要单独显示任务（不分组），请使用Group by 下拉菜单。

新的 settings 插件

AGP 8.0.0-alpha09 引入了新的 settings 插件。settings 插件可让您将全局配置（适用于所有模块的配置）集中在一个位置，这样您就不需要在多个模块中复制粘贴这些配置。此外，您可以使用 settings 插件创建工具*执行配置文件*，或用于运行工具的不同说明，并在它们之间切换。

要使用 settings 插件，请在 settings.gradle 文件中应用该插件

apply plugin 'com.android.settings'

集中管理全局配置

要配置全局配置，请在 settings.gradle 文件中使用新的 android 块。示例如下：

android {
  compileSdk 31
  minSdk 28
  ...
}

工具执行配置文件

settings 插件还允许您为某些工具创建执行配置文件。执行配置文件决定了工具的运行方式；您可以根据环境选择不同的执行配置文件。在执行配置文件中，您可以为工具设置 JVM 参数，并将其配置为在单独的进程中运行。目前仅支持 R8 工具。

在 settings.gradle 文件中创建执行配置文件并设置默认执行配置文件，示例如下：

android {
  execution {
    profiles {
      high {
        r8 {
          jvmOptions += ["-Xms2048m", "-Xmx8192m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      low {
        r8 {
          jvmOptions += ["-Xms256m", "-Xmx2048m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      ci {
        r8.runInSeparateProcess false
      }
    }
    defaultProfile "low"
  }
}

要覆盖默认配置文件，请在 gradle.properties 文件中使用 android.experimental.settings.executionProfile 属性选择不同的配置文件

android.experimental.settings.executionProfile=high

您也可以使用命令行设置此属性，这使您可以设置不同的工作流。例如，如果您有持续集成工作流，可以使用命令行更改执行配置文件，而无需更改 settings.gradle 文件

./gradlew assembleRelease \
  -Pandroid.experimental.settings.executionProfile=ci

运行 AGP 8.0 需要 JDK 17

使用 Android Gradle 插件 8.0 构建应用时，现在需要 JDK 17 来运行 Gradle。Android Studio Flamingo 捆绑了 JDK 17 并默认配置 Gradle 使用它，这意味着大多数 Android Studio 用户无需对其项目进行任何配置更改。

如果您需要在 Android Studio 中手动设置 AGP 使用的 JDK 版本，则需要使用 JDK 17 或更高版本。

在独立于 Android Studio 使用 AGP 时，可以通过将 JAVA_HOME 环境变量或 -Dorg.gradle.java.home 命令行选项设置为 JDK 17 的安装目录来升级 JDK 版本。

已修复的问题

Android Gradle 插件 8.0.0

Android Gradle 插件 8.0.1

Android Gradle 插件 8.0.2