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.gradlegradle\wrapper\gradle-wrapper.properties这两个文件进行修改[1]。

gradle-wrapper.properties

build.gradle

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

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容