彻底解决gradle与gradle plugin匹配关系以及gradle下载缓慢的问题
文章目录
问题引入
我们刚接触安卓开发，在环境搭建阶段，安装Android studio的时候或者新建一个项目的时候，往往会卡到一个地方一直等待，一直等待。。。直到最后报红线，怎么搞都不行。最后崩溃，放弃了，毁灭吧，搞不了了。
其实，就是一个gradle下载缓慢的小问题把好多新人挡在了Android开发的大门之外。
唉唉，朋友，别放弃，看这里，都是小问题。
这里给大家分享一下个人的解决方案。
原因
原因可能有两个：
- gradle版本和gradle插件版本不匹配（这个会直接导致报错）
- gradle服务器在国外，国内网络访问自然慢啊，Android Studio已经尽力了。
解决方法
1. 检查gradle版本和gradle插件版本是否匹配
- gradle版本的定义在你的
gradle-wrapper.properties
如：
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-bin.zip
上述文件中的 distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-bin.zip 表明，你使用的gradle 版本是 6.5，具体的包是gradle-6.5-bin.zip
- gradle插件版本的定义在你的
build.gradle（project级别）文件里。
如：
buildscript {
repositories {
google()
jcenter()
}
dependencies {
classpath "com.android.tools.build:gradle:4.1.0"
}
}
allprojects {
repositories {
google()
jcenter()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
上述文件中的 classpath "com.android.tools.build:gradle:4.1.0" 表明，你的gradle plugin（插件）版本是 4.1.0
那么， 6.5 版本的 gradle 和 4.1.0 版本的gradle plugin匹配吗？怎么号不太一样？
答案是匹配的！这两个的匹配关系有个表格，官方地址是：gradle与gradle plugin匹配关系。
当前已有的关系如下表：
所以，这下知道了吧。好多工程编译出错都可能是这两个版本号的关系没匹配造成的。
2. 解决gradle下载慢的问题
手动下载gradle包
既然Android studio下载不下来，那么我们可以手动下载啊。这里是gradle的官方下载地址：https://services.gradle.org/distributions/
点进去，下载对应的版本就行了。如果还下载不下来，试试国内的gradle镜像地址：https://mirrors.cloud.tencent.com/gradle/
举个例子：
如我们需要gradle-6.5.all.zip这个包，下载好之后，需要把它放到你电脑的
C:\Users\fxjzz\.gradle\wrapper\dists\gradle-6.5-all\2oz4ud9k3tuxjg84bbf55q0tn
这个目录下，不用解压，在打开工程后android studio会自动帮我们解压。
注意
- 上述路径的
fxjzz是我电脑的用户名，你的电脑是对应自己的用户名。- 如果你的
dists下没有对应的gradle版本文件夹，你需要打开你的Android studio项目，它会开始sync，也就是下载需要的gradle，这时候就会自动在你的dists目录下创建gradle-6.5-all文件夹，以及后面的一串乱七八糟字母的子文件夹2oz4ud9k3tuxjg84bbf55q0tn，这个名字是随机生成的，你的肯定和我这个不一样。
这样手动下载了就好了吗？
可能还不够。。。
当我们手动下载，并且放置到对应位置，重新打开工程，可能会发现下面的进度仍然显示在下载某些东西。瓦特？这是搞什么？！！
没错，它还要下一些东西。这时候如果你的网络下不下来，依然会非常慢，甚至报错。
上述情况只是可能，有的人可能不会遇到，很顺利的一会儿就成功了。
对于上述情况，
在手动下了gradle后，我们再增加一道措施：替换依赖仓库为国内的仓库地址。
替换依赖仓库为国内地址
这里也有两种方法。
方法一：在build.gradle（project级别）里改变依赖仓库
buildscript {
repositories {
// google()
// jcenter()
maven {url 'https://maven.aliyun.com/repository/jcenter'}
maven {url 'https://maven.aliyun.com/repository/google'}
maven {url 'http://maven.aliyun.com/nexus/content/repositories/jcenter'}
}
dependencies {
classpath "com.android.tools.build:gradle:4.0.0"
}
}
allprojects {
repositories {
// google()
// jcenter()
maven {url 'https://maven.aliyun.com/repository/jcenter'}
maven {url 'https://maven.aliyun.com/repository/google'}
maven {url 'http://maven.aliyun.com/nexus/content/repositories/jcenter'}
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
即，用国内的代理仓库地址取代google和jcenter这两个仓库地址。
方法二：配置全局替换的文件（推荐）
在.gradle文件夹下添加仓库替代的配置文件init.gradle，这样可以为所有工程自动替换仓库。不需要每新建一个工程都修改里面的build.gradle文件了。
创建一个init.gradle文件，内容如下：
gradle.projectsLoaded {
rootProject.allprojects {
buildscript {
repositories {
def JCENTER_URL = 'https://maven.aliyun.com/repository/jcenter'
def GOOGLE_URL = 'https://maven.aliyun.com/repository/google'
def NEXUS_URL = 'http://maven.aliyun.com/nexus/content/repositories/jcenter'
all { ArtifactRepository repo ->
if (repo instanceof MavenArtifactRepository) {
def url = repo.url.toString()
if (url.startsWith('https://jcenter.bintray.com/')) {
project.logger.lifecycle "Repository ${repo.url} replaced by $JCENTER_URL."
println("buildscript ${repo.url} replaced by $JCENTER_URL.")
remove repo
}
else if (url.startsWith('https://dl.google.com/dl/android/maven2/')) {
project.logger.lifecycle "Repository ${repo.url} replaced by $GOOGLE_URL."
println("buildscript ${repo.url} replaced by $GOOGLE_URL.")
remove repo
}
else if (url.startsWith('https://repo1.maven.org/maven2')) {
project.logger.lifecycle "Repository ${repo.url} replaced by $REPOSITORY_URL."
println("buildscript ${repo.url} replaced by $REPOSITORY_URL.")
remove repo
}
}
}
jcenter {
url JCENTER_URL
}
google {
url GOOGLE_URL
}
maven {
url NEXUS_URL
}
}
}
repositories {
def JCENTER_URL = 'https://maven.aliyun.com/repository/jcenter'
def GOOGLE_URL = 'https://maven.aliyun.com/repository/google'
def NEXUS_URL = 'http://maven.aliyun.com/nexus/content/repositories/jcenter'
all { ArtifactRepository repo ->
if (repo instanceof MavenArtifactRepository) {
def url = repo.url.toString()
if (url.startsWith('https://jcenter.bintray.com/')) {
project.logger.lifecycle "Repository ${repo.url} replaced by $JCENTER_URL."
println("buildscript ${repo.url} replaced by $JCENTER_URL.")
remove repo
}
else if (url.startsWith('https://dl.google.com/dl/android/maven2/')) {
project.logger.lifecycle "Repository ${repo.url} replaced by $GOOGLE_URL."
println("buildscript ${repo.url} replaced by $GOOGLE_URL.")
remove repo
}
else if (url.startsWith('https://repo1.maven.org/maven2')) {
project.logger.lifecycle "Repository ${repo.url} replaced by $REPOSITORY_URL."
println("buildscript ${repo.url} replaced by $REPOSITORY_URL.")
remove repo
}
}
}
jcenter {
url JCENTER_URL
}
google {
url GOOGLE_URL
}
maven {
url NEXUS_URL
}
}
}
}
把这个文件放到C:\Users\fxjzz\.gradle这个目录下。这里 fxjzz 是我的用户名，你自己的电脑会有自己的用户名。
设置gradle 离线模式
如果还是不行的话，试试打开 gradle 的离线模式吧。gradle 默认是在线模式，也就是缺什么包，它自己在线下载什么包。虽然我们上面已经手动下载好了 gradle 包，并放到了上述的目录下，但傻傻的 android studio 还是走自己在线下载 gradle 的路子，不撞南墙不回头啊。
因此，我们可能还需要再帮它一把，告诉它，走离线模式吧，我已经帮你下载好了 gradle 了。
如下图所示，点击箭头所指图标即可打开 “gradle 离线模式”,再次点击就是关闭。 打开后，重新 sync 即可静待奇迹发生。
好了，这样gradle下载缓慢的问题，应该能彻底的被解决啦~
再也不用气到崩溃啦~
旨在为数千万中国开发者提供一个无缝且高效的云端环境，以支持学习、使用和贡献开源项目。
更多推荐
70
0- 0
已为社区贡献3条内容
所有评论(0)