Android Studio - gradle配置踩坑

1.问题

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

《Android Studio - gradle配置踩坑》 Building XXX Gradle project info

2.分析

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

《Android Studio - gradle配置踩坑》 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是项目级的,优先级高于全局级的设置。

《Android Studio - gradle配置踩坑》 Gradle Location

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

《Android Studio - gradle配置踩坑》 .gradle/wrapper/dists

并确保Gradle的完整性。

《Android Studio - gradle配置踩坑》 ensure gradle’s integrity

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

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

《Android Studio - gradle配置踩坑》 plugin version|required gradle version

博主的本地环境为

plugin versionrequired gradle version
2.2.22.14.1

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

《Android Studio - gradle配置踩坑》 gradle-wrapper.properties

《Android Studio - gradle配置踩坑》 build.gradle

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

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

    原文作者:芥丶未央
    原文地址: https://www.jianshu.com/p/33089ca7c98e
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞