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 false
    id 'com.android.library' version '7.4.1' apply false
    id '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