Android Studio - gradle配置踩坑

1.问题

当我们从团队协作者或者开源Android项目网站上获取以Gradle构建的Android项目，并点击Open an existing Android Studio project将它导入Android Studio时，经常遇到如下Android Studio未响应的问题：

Building XXX Gradle project info

2.分析

查看idea.log，我们得知问题是由Started sync with Gradle时造成Connection Failed而引发的。

idea.log

原因之一可能是该Android项目所需的Gradle版本与本地存在的Gradle版本并不适配。因此，Android Studio会自动去下载该Android项目所需的Gradle版本。

然而，却跪倒在GFW面前。

3.解决

通过在Android Studio中依次点击File > Settings > Build, Execution, Deployment > Gradle,我们可以锁定当前项目使用的Gradle的位置。[2]

- 若选中`Use default gradle wrapper(recommended)`,则设置的Gradle位置为`Service directory path`中的路径；
- 若选中`Use local gradle distribution`，则设置的Gradle位置为`Gradle home`中的路径。

注：Service directory path是全局级的，Use default gradle wrapper(recommended)与Use local gradle distribution是项目级的，优先级高于全局级的设置。

Gradle Location

因此，根据当前设置，我们在C:\Users\%Your_User_Name%\.gradle\wrapper\dists目录下找到当前已安装的Gradle，

.gradle/wrapper/dists

并确保Gradle的完整性。

ensure gradle's integrity

下图是Android Studio Gradle插件版本与Gradle版本之间的对应关系[1]。

Gradle插件版本一般继承自Android Studio的版本。

plugin version|required gradle version

博主的本地环境为

plugin version	required gradle version
2.2.2	2.14.1

因此，对该Android项目的build.gradle和gradle\wrapper\gradle-wrapper.properties这两个文件进行修改[1]。

gradle-wrapper.properties

build.gradle

修改过后，可对该Android项目进行正常导入，并且不会出现上述的未响应情况。

参考文献：
1 Android Plugin for Gradle Release Notes
2 Configure Gradle project settings