一、背景
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 |