Android Studio插件版本与Gradle 版本、kotlin版本等对应关系

关于作者：CSDN内容合伙人、技术专家， 从零开始做日活千万级APP。
专注于分享各领域原创系列文章 ，擅长java后端、移动开发、商业变现、人工智能等，希望大家多多支持。

一、导读

我们继续总结学习基础知识，温故知新。

本文记录android studio插件版本 与 所需的最低 Gradle 版本的对应关系。

二、概览

Android Studio 构建系统以 Gradle 为基础，并且 Android Gradle 插件添加了几项专用于构建 Android 应用的功能。
虽然 Android 插件通常会与 Android Studio 的更新步调保持一致，但插件（以及 Gradle 系统的其余部分）可独立于 Android Studio 运行并单独更新。

我们在下载其他人的项目后进行运行，经常会遇到插件版本不一致的情况， 但是又不知道该用那个版本，所以写本文记录一下。

* Where:
Build file 'xxx\app\build.gradle' line: 1


* What went wrong:
A problem occurred evaluating project ':app'.
> Failed to apply plugin [id 'com.android.application']
   > Gradle version xxx is required. Current version is xxxx. If using the gradle wrapper, try editing the distributionUrl in \gradle\wrapper\gradle-wrapper.properties to gradle-xxx.zip


* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.

针对这样的问题，我们将 android studio、插件版本、Gradle 版本 三者的关系对应起来就可以解决问题了。

三、Gradle各版本对应关系

Android Gradle 插件 简称(AGP)

可以在 Android Studio 的 File > Project Structure > Project 菜单中指定插件版本，也可以在顶级 build.gradle.kts 文件中指定。
该插件版本适用于在相应 Android Studio 项目中构建的所有模块。以下示例从 build.gradle.kts 文件中将插件的版本号设置为 8.8.0：
eg:

plugins {
    id 'com.android.application' version '8.8.0' apply false
    id 'com.android.library' version '8.8.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.0.20' apply false
}

3.1 Gradle 版本

gradle的版本定义在项目的gradle/wrapper/gradle-wrapper.properties文件中

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.2-bin.zip

3.2 插件版本

目前有几种写法，一些老版本是通过classpath的方式引用：

classpath com.android.tools.build:gradle:7.4.2

或者新的引用方式

plugins {
    id 'com.android.application' version '7.4.1' apply false
    id 'com.android.library' version '7.4.1' apply false
    id 'org.jetbrains.kotlin.android' version '1.5.31' apply false
}

如果指定的插件版本尚未下载，则 Gradle 会在您下次构建项目时进行下载；或者，您也可以在 Android Studio 菜单栏中依次点击 File > Sync Project with Gradle Files 进行下载。

以下列出了目前最新的版本间对应关系

3.3 Android Gradle 插件和 Android Studio 兼容性

Android Studio 构建系统以 Gradle 为基础，并且 Android Gradle 插件添加了几项专用于构建 Android 应用的功能。下表列出了各个 Android Studio 版本所需的 Android Gradle 插件版本。

3.4 特定 Android API 级别所要求的最低工具版本

Android Studio 和 AGP 需要满足最低版本要求才能支持特定 API 级别。如果使用的 Android Studio 或 AGP 版本低于项目的 targetSdk 或 compileSdk 所要求的版本，可能会导致意外问题。我们建议您使用最新的预览版 Android Studio 和 AGP 来处理以预览版 Android OS 为目标平台的项目

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

Android Gradle 插件版本说明

3.5 AGP 和 Kotlin Gradle plugin (KGP) 版本的对应关系

参考

3.6 Compose 和 Kotlin Gradle plugin (KGP) 版本对应关系

参考

四、 推荐阅读

Java 专栏

SQL 专栏

数据结构与算法

Android学习专栏