【Kotlin/Java】 Gradle下载失败/超时如何解决

6 阅读3分钟

前言

很多朋友兴致勃勃地准备学习 Kotlin/Java 开发,结果遇到的第一个问题就是 Gradle 下载失败。这算是开发生涯的第一关,而今后开发中还有不少问题需要自己查资料、想办法解决。

因为审核原因,修改了部分词汇

解决方式

配置那啥或使用国内镜像源

配置那啥

如果你使用的是猫那啥软件(需要开启局域网访问)
代理地址为 localhost
代理端口为 7890或7897

Gradle配置

修改 C:\Users\<用户名>\.gradle\ 下的 gradle.properties 文件(不存在就创建)
在文件尾部加入以下条目并修改

systemProp.http.proxyHost=<那啥地址>
systemProp.http.proxyPort=<那啥端口>
systemProp.https.proxyHost=<那啥地址>
systemProp.https.proxyPort=<那啥端口>

IDEA/Android Studio配置

将光标移动到左上角的 菜单(三条线) 后单击 设置(Settings) 打开设置界面,接着进入 Appearance & Behavior(外观与行为) -> System Settings(系统设置)-> HTTP Proxy(HTTP那啥)

将 Host name(域名) 设置为你的那啥地址
将 Port number(端口) 设置为你的那啥端口

配置国内镜像源

配置Gradle本体镜像源

这里推荐使用腾讯的镜像源

打开项目中的 /gradle/wrapper/gradle-wrapper.properties 文件,重点关注 distributionUrl 项

distributionUrl=https\://services.gradle.org/distributions/gradle-<版本号>-bin.zip

将其修改为以下格式

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-<版本号>-bin.zip

注意
旧版IDEA/Android Studio并不会帮你自动切换到镜像源下载Gradle源代码
需将URL中的bin替换为all,例如 gradle-<版本号>-all.zip
如果不确定当前版本是否会自动下载源码,可以观察构建或同步过程:若长时间卡在与 src 相关的下载上,就需要进行上述替换。

配置Gradle仓库镜像源

Gradle 文件后缀:.kts 是 Kotlin DSL,.gradle 是 Groovy DSL。

Groovy DSL

打开项目下的 settings.gradle 文件

pluginManagement {
    repositories {
        // 非 Android 项目不存在下方一整块
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        // ------
        
        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google() // 非 Android 项目可能不存在本行
        mavenCentral()
    }
}

请修改为以下版本

pluginManagement {
    repositories {
        // 非 Android 项目可删除下方第一行
        maven { url "https://maven.aliyun.com/repository/google" } 
        
        maven { url "https://maven.aliyun.com/repository/public" }
        maven { url "https://maven.aliyun.com/repository/gradle-plugin" }
        
        // 非 Android 项目不存在下方一整块
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        // ------
        
        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // 非 Android 项目可删除下方第一行
        maven { url "https://maven.aliyun.com/repository/google" }
        maven { url "https://maven.aliyun.com/repository/public" }
    
        google() // 非 Android 项目可能不存在本行
        mavenCentral()
    }
}

如果你的 settings.gradle 中没有以上内容,请直接复制修改版

Kotlin DSL

打开项目下的 settings.gradle.kts 文件

pluginManagement {
    repositories {
        // 非 Android 项目不存在下方一整块
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        // ------

        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()  // 非 Android 项目可能不存在本行
        mavenCentral()
    }
}

请修改为以下版本

pluginManagement {
    repositories {
        // 非 Android 项目可删除下方第一行
        maven("https://maven.aliyun.com/repository/google")

        maven("https://maven.aliyun.com/repository/public")
        maven("https://maven.aliyun.com/repository/gradle-plugin")

        // 非 Android 项目不存在下方一整块
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        // ------

        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // 非 Android 项目可删除下方第一行
        maven("https://maven.aliyun.com/repository/google")

        maven("https://maven.aliyun.com/repository/public")

        google()  // 非 Android 项目可能不存在本行
        mavenCentral()
    }
}

如果你的 settings.gradle.kts 中没有以上内容,请直接复制修改版