Android Studio 与 Gradle 及插件版本兼容性

Android Studio 开始新项目时，会自动创建其中部分文件，并为其填充合理的默认值。

项目文件结构布局：

 一、Android Gradle 及插件作用：

Android Studio 构建系统以 Gradle 为基础，并且 Android Gradle 插件 (AGP) 添加了几项专用于构建 Android 应用的功能。

Android 构建系统会编译应用资源和源代码，然后将它们打包成 APK 或 Android App Bundle 文件，供测试、部署、签名和分发。

Android Studio 使用高级构建工具包 Gradle 来自动执行和管理构建流程，同时也允许自行指定灵活的 build 配置。每项 build 配置均可定义各自的一组代码和资源，同时重复利用所有应用版本共用的部分。Android Gradle 插件与该构建工具包搭配使用，提供专用于构建和测试 Android 应用的流程和可配置设置。

Gradle 和 Android Gradle 插件独立于 Android Studio 运行。这意味着，您可以在 Android Studio 内、计算机上的命令行或未安装 Android Studio 的计算机（如持续集成服务器）上构建 Android 应用。

Android Studio 和 AGP 需要满足最低版本要求才能支持特定 API 级别。如果使用的 Android Studio 或 AGP 版本低于项目的 targetSdk 或 compileSdk 所要求的版本，可能会导致意外问题。

Android Studio 和 AGP 的最低版本如下所示：

谷歌宣称将更新 Android Gradle 插件 (AGP) 的版本号，以使其更接近底层 Gradle 构建工具。

重要变更如下：

• AGP 现在将使用语义版本控制，并且重大变更将在主要版本中发布。

• 每年将发布一个 AGP 主要版本，与 Gradle 主要版本保持一致。

• AGP 4.2 之后的版本为版本 7.0，并且会要求升级到 Gradle 7.x 版。AGP 的每个主要版本都会要求在底层 Gradle 工具中进行主要版本升级。

• API 将提前大约一年废弃，同时提供替代功能。弃用的 API 将在大约一年后的下次主要版本更新期间移除。

Android Gradle 插件 8.3 支持的最高 API 级别为 API 级别 34。下面是其他兼容性信息：

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

二、Android Studio 版本与 AGP 版本兼容性：

下表列出了各个 Android Studio 版本所需的 AGP 版本。

Android Studio 版本	所需 AGP 版本
Koala | 2024.1.1	3.2-8.5
Jellyfish | 2023.3.1	3.2-8.4
Iguana | 2023.2.1	3.2-8.3
Hedgehog | 2023.1.1	3.2-8.2
Giraffe | 2022.3.1	3.2-8.1
Flamingo | 2022.2.1	3.2-8.0
Electric Eel | 2022.1.1	3.2-7.4
Dolphin | 2021.3.1	3.2-7.3
Chipmunk | 2021.2.1	3.2-7.2
Bumblebee | 2021.1.1	3.2-7.1
Arctic Fox | 2020.3.1	3.1-7.0

三、Gradle 版本与 AGP 版本兼容性：

更新 Android Studio 时，可能会收到一并将 Gradle 更新为最新可用版本的提示。

可以选择接受该更新，也可以根据项目的构建要求手动指定版本。

下表列出了各个 Android Gradle 插件版本所需的 Gradle 版本。为了获得最佳性能，最好使用 Gradle 和插件这两者的最新版本。

插件版本	所需最低 Gradle 版本
8.4	土耳其里拉
8.3	8.4
8.2	8.2
8.1	8
8	8
7.4	7.5
7.3	7.4
7.2	7.3.3
7.1	7.2
7	7
4.2.0+	6.7.1
4.1.0+	6.5+
4.0.0+	6.1.1+
3.6.0 - 3.6.4	5.6.4+
3.5.0 - 3.5.4	5.4.1+
3.4.0 - 3.4.3	5.1.1+
3.3.0 - 3.3.3	4.10.1+
3.2.0 - 3.2.1	4.6+
3.1.0+	4.4+
3.0.0+	4.1+
2.3.0+	3.3+
2.1.3 - 2.2.3	2.14.1 - 3.5
2.0.0 - 2.1.2	2.10 - 2.13
1.5.0	2.2.1 - 2.13
1.2.0 - 1.3.1	2.2.1 - 2.9
1.0.0 - 1.1.3	2.2.1 - 2.3

                                                                                         老徐，2024/5/19