【Android Studio】AS版本、SDK版本、gradle版本以及gradle-plugin（AGP版本）实战干活一网打尽

原创已于 2024-09-14 23:10:18 修改 · 5.6k 阅读

39 ·

CC 4.0 BY-SA版权

文章标签：

#android studio #android #ide

于 2024-08-02 09:07:05 首次发布

Android 专栏收录该内容

35 篇文章

订阅专栏

文章目录

Gradle 是一个基于 Apache Ant 和 Apache Maven 概念的自动化构建工具，Gradle 提供了更灵活和强大的方式来构建、测试、打包和部署应用程序，它支持多种编程语言和平台，包括 Java、Kotlin、Groovy、Android、C/C++ 等。

AS查看gradle-plugin版本及gradle版本（图形）

在这里插入图片描述

查看gradle-plugin版本及gradle版本（配置文件）

进入项目级bulid.gradle(不是app级)
gradle\wrapper\gradle-wrapper.properties

在这里插入图片描述

配置文件分析

gradle-plugin
这里主要解决第一次构建项目时可能出现的问题，不考虑具体项目配置，涉及到的配置文件就上图两个。
项目级build.gradle：项目全局的gradle构建脚本（下面是uniapp 安卓SDK实例）
（注意不要找到app文件夹里的那个了）

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        maven {url 'https://maven.aliyun.com/repository/google'}
        maven {url 'https://maven.aliyun.com/repository/gradle-plugin'}
        maven {url 'https://maven.aliyun.com/repository/public'}
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:4.1.1'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        maven {url 'https://maven.aliyun.com/repository/google'}
        maven {url 'https://maven.aliyun.com/repository/gradle-plugin'}
        maven {url 'https://maven.aliyun.com/repository/public'}
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

gradle
repositories中配置的是仓库地址，Android Studio会从这里的地址下载gradle等工具。
gradle-wrapper.properties：配置gradle

#Mon Dec 28 18:07:31 CST 2020
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-all.zip

解决gradle下载失败、版本错乱等问题。

配置国内源
https://blog.youkuaiyun.com/xzzteach/article/details/140911608

首先配置国内的源，这里用阿里云的仓库
https://developer.aliyun.com/mvn/guide
在build.gradle文件中把 google() 和 jcenter() 注释掉，并添加

在这里插入图片描述
gradle版本和plugin版本是有对应关系的，版本错误的话可能会发生异常，具体对应关系见网址https://developer.android.com/studio/releases/gradle-plugin
（注：需要科学上网才能打开）
这里贴一个当前最新的对应关系表，如果不追求最新版的话应该够用了（请看附件）。

手动下载gradle
如果因为某些原因无法自动下载或解压gradle，可以手动进行下载并自行放置。
gradle文件所在的地址是
C:\Users\用户名\.gradle\wrapper\dists
打开以后就会看见不同版本的gradle

其中bin后缀的是只包含二进制文件，all后缀的包括二进制文件、文档和源代码，根据自己的需求进行选择。

进入任意一个gradle目录中都会有一个乱码文件夹，这个是必须的，如果gradle无法下载，也点击Android Studio中的Sync按钮让它去生成这个乱码文件夹，好让我们去手动放置。
在这里插入图片描述

选择好gradle版本后，开始手动下载，官方地址：https://gradle.org/releases/
以我使用的8.7为例
在这里插入图片描述

binary-only就是bin版本，complete就是all版本，自行选择进行下载即可。
下载完成后会得到一个zip压缩包，注意不要解压。把压缩包放到刚才提到的乱码文件夹中。
在这里插入图片描述

接下来重启Android Studio，它会自动进行解压并完成配置。

如果重启后还是在下载gradle文件，这时候就去看看是不是bin和all对应不上，比如项目需要bin版本的gradle，而你放了一个all版本的压缩包进去，那它当然还会下载。
这时候进入gradle-wrapper.properties 文件中，最后一行把bin改成all就解决问题了。
在这里插入图片描述

附件1 插件版本（AGP）与Gradle 版本对应关系

plugin(AGP)	gradle
8.4 (alpha)	8.6-rc-1
8.3	8.4
8.2	8.2
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
4.1.0+	6.5+
4.0.0+	6.1.1+
3.6.0 - 3.6.4	5.6.4+
3.5.0 - 3.5.4	5.4.1+
3.4.0 - 3.4.3	5.1.1+
3.3.0 - 3.3.3	4.10.1+
3.2.0 - 3.2.1	4.6+
3.1.0+	4.4+
3.0.0+	4.1+
2.3.0+	3.3+
2.1.3 - 2.2.3	2.14.1 - 3.5
2.0.0 - 2.1.2	2.10 - 2.13
1.5.0	2.2.1 - 2.13
1.2.0 - 1.3.1	2.2.1 - 2.9
1.0.0 - 1.1.3	2.2.1 - 2.37.3 7.4

附件2 Gradle 版本与所支持的 JDK 版本对应关系

Gradle 版本	JDK 版本
6.x	JDK 8、JDK 11（仅限 Gradle 6.7 及更高版本）
5.x	JDK 7、JDK 8
4.x	JDK 6、JDK 7、JDK 8
3.x	JDK 6、JDK 7、JDK 8
2.x	JDK 6、JDK 7、JDK 8
1.x	JDK 6、JDK 7

附件3 Android Studio 版本与 AGP 版本兼容性

下表列出了各个 Android Studio 版本所需的 AGP 版本。

Android Studio 版本	所需 AGP 版本
Koala 2024.1.1	3.2-8.5
Jellyfish 2023.3.1	3.2-8.4
Iguana 2023.2.1	3.2-8.3
Hedgehog 2023.1.1	3.2-8.2
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