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

一、背景

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

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

二、Gradle各版本对应关系

2.1 Gradle 版本配置

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

#Mon Oct 28 11:24:43 CST 2024
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-5.4.1-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

2.2 插件版本

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

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

或者用新的写法

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

目前最新的版本间对应关系

插件版本	所需的最低 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

2.3 Android Gradle 插件和 Android Studio 兼容性 

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

Android Studio 版本	所需插件版本
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

详细可查看：AndroidPluginVersion  |  Android Developers