Android Studio 3.1.2构建超时，求助手动安装builder.jar及全局依赖配置

一、手动安装已下载的builder-3.1.2.jar #

当你遇到下载超时或资源获取失败的问题时，把手动下载的jar包放到Gradle本地缓存目录，就能让Android Studio自动识别到，具体步骤如下：

• 打开Gradle本地缓存路径：Windows用户一般是C:\Users\你的用户名\.gradle\caches\modules-2\files-2.1，Mac/Linux用户则是~/.gradle/caches/modules-2/files-2.1
• 在该路径下手动创建层级目录：com/android/tools/build/builder/3.1.2，如果目录已存在直接跳过
• 将你下载好的builder-3.1.2.jar放入这个3.1.2目录中
• 重启Android Studio并点击"Sync Project with Gradle Files"，如果仍有提示，可检查同目录下是否缺失.module等校验文件——如果缺失，可从能正常下载的环境复制一份，或者直接清理项目缓存后重新同步

二、实现一次下载供所有项目使用（全局复用） #

要避免重复下载依赖，推荐两种全局复用方案：

方法1：利用Gradle全局缓存（最简便）

上面的手动安装操作本质就是利用了Gradle的全局缓存机制——只要jar包存放在.gradle/caches的对应路径下，所有使用3.1.2版本Android Gradle插件的项目，都会自动从本地缓存读取该文件，无需重复下载。

方法2：配置自定义全局本地仓库

如果你想更灵活地管理本地依赖，可以创建一个专属本地仓库，让所有项目优先从这里读取：

• 在电脑任意位置创建一个文件夹，比如D:\AndroidLocalRepo（Windows）或~/AndroidLocalRepo（Mac/Linux）
• 按照Maven仓库的目录结构存放jar包：com/android/tools/build/builder/3.1.2/builder-3.1.2.jar
• 编辑用户目录下的.gradle/init.gradle文件（如果没有就新建），添加以下配置：

allprojects {
    repositories {
        // Windows路径注意转义，Mac/Linux替换为对应本地仓库路径
        maven { url 'file:///D:/AndroidLocalRepo' }
        google()
        jcenter()
    }
}

这样所有项目构建时都会优先从你的本地仓库查找依赖，找不到再去远程仓库请求。

额外优化：解决网络超时根源问题 #

你提到使用Hotspot Shield后创建项目，大概率是网络不稳定导致的下载超时。可以在项目根目录的build.gradle中配置国内镜像源，提升下载稳定性：

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        google()
        jcenter()
    }
    // 保留原有的dependencies配置
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        google()
        jcenter()
    }
}

内容的提问来源于stack exchange，提问作者Bahadori