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