init.gradle 文件解决 Gradle 编译过程中网络访问失败的问题

2019-12-24

开发工具 Android Studio 使用 Gradle 构建工程的过程中，由于网络原因偶尔会出现 Sync 失败的情况，Build 窗口报错内容为：

1	ERROR: Connection reset

和

1 2	Caused by: org.gradle.api.internal.artifacts.ivyservice.DefaultLenientConfiguration$ArtifactResolveException: Could not resolve all files for configuration ':classpath'. ......

出现这种问题的原因是，项目工程中 Gradle 配置的 google() 或 jcenter() 等远程仓库，对于国内这种网络，访问不是很通畅，下载依赖内容很容易失败。

这个时候，我们可以修改 Gradle 配置文件，借助各种第三方开源镜像网站替换 repositories 配置项的内容。可以直接修改工程根目录下的 build.gradle 文件，针对单一项目生效；也可以借助电脑用户目录下的 init.gradle 文件，所有项目统一修改。

这里我们主要看下使用 init.gradle 文件的方式，电脑中 gradle 的本地缓存目录里面默认是没有这个文件的，我们可以手动添加，文件内容可以是这样的：

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/public/' }
        maven { url 'https://maven.aliyun.com/nexus/content/repositories/google' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
        maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter'}
        all { ArtifactRepository repo ->
            if (repo instanceof MavenArtifactRepository) {
                def url = repo.url.toString()
                if (url.startsWith('https://repo.maven.apache.org/maven2/') || url.startsWith('https://repo.maven.org/maven2') || url.startsWith('https://repo1.maven.org/maven2') || url.startsWith('https://jcenter.bintray.com/')) {
                    //project.logger.lifecycle "Repository ${repo.url} replaced by $REPOSITORY_URL."
                    remove repo
                }
            }
        }
    }
    buildscript {
        repositories {
            maven { url 'https://maven.aliyun.com/repository/public/'}
            maven { url 'https://maven.aliyun.com/nexus/content/repositories/google' }
            maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
            maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter'}
            all { ArtifactRepository repo ->
                if (repo instanceof MavenArtifactRepository) {
                    def url = repo.url.toString()
                    if (url.startsWith('https://repo1.maven.org/maven2') || url.startsWith('https://jcenter.bintray.com/')) {
                        //project.logger.lifecycle "Repository ${repo.url} replaced by $REPOSITORY_URL."
                        remove repo
                    }
                }
            }
        }
    }
}

这里是利用阿里云开源镜像站替换掉网络访问困难的 maven、jcenter 等仓库地址，可以参考一下，当然也可以按需求改。

默认情况下，init.gradle 文件放置于 Gradle 缓存目录 /Users/{username}/.gradle 目录中。Gradle 缓存目录可以在 Android Studio 的设置项 Gradle 窗口查看和修改：

Service directory path

关于 init.gradle 配置文件的详细介绍可以参考链接：

本文由亦枫创作并首发于 亦枫的个人博客 ，同步推送微信公众号：安卓笔记侠（androidnotebyyifeng）。

欢迎各种形式地交流与转载，注明作者、出处和微信公众号即可。

本文标题为: init.gradle 文件解决 Gradle 编译过程中网络访问失败的问题

本文链接为：https://woyifeng.com/2019/12/24/init-gradle-file-fix-gradle-network-issue/