版本兼容性规则

Android Gradle插件(AGP)版本与Gradle版本之间存在严格的兼容性要求:

  1. 基本兼容规则‌:

    • AGP 8.x → 需要Gradle 8.x
    • AGP 7.4.x → 需要Gradle 7.5+
    • AGP 7.0-7.3 → 需要Gradle 7.0+
    • 版本不匹配会导致构建错误810
  2. 推荐版本组合‌:

    • AGP 8.2.0 + Gradle 8.5
    • AGP 7.4.2 + Gradle 7.5
    • AGP 7.0.4 + Gradle 7.0.2
    • AGP 4.2.2 + Gradle 6.7.1
  3. JDK兼容性‌:

    • AGP 8.0+ 强制要求JDK 17
    • AGP 7.0-7.5 推荐JDK 11(部分兼容JDK 8)
    • AGP 4.2+ 最低要求JDK 812

例如:gradle 插件版本 4.2.2对应gradle 发行版本以及支持的 kotlin版本  如下:
项目 build.gradle文件中:
buildscript {

    dependencies {
        classpath "com.android.tools.build:gradle:4.2.2"
        classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.20'
    }
}

gradle-wrapper.properties 文件中:
distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-bin.zip

如果国外的gradle没法下载,可以使用国内腾讯镜像,例如上面 gradle-6.7.1-bin.zip url对应地址如下
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-6.7.1-bin.zip

如果maven引用报如下错误,需要检查一下将每个添加的maven添加allowInsecureProtocol = true,例如:
    maven {
            //如果报如下错误,需要添加allowInsecureProtocol = true
            allowInsecureProtocol = true
            url 'https://maven.aliyun.com/repository/public/'
        }
Using insecure protocols with repositories, without explicit opt-in, is unsupported. Switch Maven repository 'maven4(http://lib.gcssloop.com/repository/gcssloop-central/)' to redirect to a secure protocol (like HTTPS) or allow insecure protocols. See https://docs.gradle.org/7.5/dsl/org.gradle.api.artifacts.repositories.UrlArtifactRepository.html#org.gradle.api.artifacts.repositories.UrlArtifactRepository:allowInsecureProtocol for more details.

官方匹配关系如下链接:
https://developer.android.com/studio/releases/gradle-plugin
 

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐