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

关于作者：优快云内容合伙人、技术专家， 从零开始做日活千万级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 进行下载。

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

插件版本	所需的最低 Gradle 版本
8.1	8.0
8.0	8.0
7.4	7.5
7.3	7.4
7.2	7.3.3
7.1	7.2
7.0	7.0
4.2.0+	6.7.1

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学习专栏