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

关于作者：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各版本对应关系

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 插件版本。

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