前言
很多朋友兴致勃勃地准备学习 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中没有以上内容,请直接复制修改版