Android Gradle 插件版本（AGP）与当前环境不兼容

在开发安卓程序时，经常会出现AGP与当前环境不一致的问题；

解决办法： 修改 libs.versions.toml中的agp设置 ； gradle-wrapper.properties中的distributionUrl

• 找到工程目录->gradle->libs.versions.toml
• 检查其中的配置项 agp

• 找到工程目录->gradle->wrapper->gradle-wrapper.properties
• 检查其中的配置项 distributionUrl

Android Studio 与 AGP 版本对应关系

说明​​：

• AS 新版本通常兼容旧版 AGP，但旧版 AS 无法支持新版 AGP。
• 在 File > Project Structure > Project 中可手动修改 AGP 版本

AGP 与 Gradle 版本对应关系

AGP 版本严格依赖特定 Gradle 版本，否则构建将失败

配置位置​​

• AGP 版本：项目根目录的 build.gradle 文件（com.android.tools.build:gradle）。
• Gradle 版本：gradle-wrapper.properties 文件的 distributionUrl

Gradle 与 JDK 版本对应关系

Gradle 版本决定了支持的 JDK 版本：

​​关键限制​​：

• AGP 8.0+ 强制要求 JDK 17​​，AGP 7.x 支持 JDK 11（官方推荐），AGP 4.2+ 最低需 JDK 8。
• Android Studio 内置 JDK（Embedded JDK）可自动匹配，但大型项目建议独立配置 JDK

Gradle 与 Kotlin 版本对应关系

Kotlin 插件版本需与 Gradle 及 AGP 兼容：

AGP 兼容性​​

• AGP 8.x 需 Kotlin ≥1.8.20，AGP 7.x 需 Kotlin ≥1.7.20。
• 在 build.gradle 中指定 Kotlin 插件版本：

plugins {
    id 'org.jetbrains.kotlin.android' version '1.9.20'
}

plugins {
    id 'org.jetbrains.kotlin.android' version '1.9.20'
}