Android Studio之Gradle构建记录
什么是Gradle？
Gradle是一个基于 Apache Ant 和 Apache Maven 概念的项目自动化构建工具，支持依赖管理和多项目，类似 Maven，但比之简单轻便。它使用一种基于 Groovy 的特定领域语言来声明项目设置，而不是传统的 XML。
对于Android开发的小伙伴，可以参考Gradle 完整指南（Android）。
什么是Android Gradle plugin？
Android Gradle Plugin是Google为Android Studio引入Gradle构建系统，开发的一系列插件。
Android Studio经常性的升级，在升级时还不忘提醒用户，让你感受新的功能和性能提升。比如它又建议我：
```
To take advantage of all the latest features (such as Instant Run), improvements and security fixes, we strongly recommend that you update the Android Gradle plugin to version 3.1.2 and Gradle to version 4.4. You can learn more about this version of the plugin from the release notes.
```
如果你每次都遵从建议的话，却不明白原理的话，你可能会中招。
中招１：版本不一致导致的基本问题
错误提升信息：
Minimum supported Gradle version is 3.3. Current version is 3.2.1.
Please fix the project's Gradle settings.Fix Gradle wrapper and re-import project Gradle settings
或
Gradle sync failed: Minimum supported Gradle version is 4.4. Current version is 4.1. If using the gradle wrapper, try editing the distributionUrl in /work/mapboom/mapboom-gl-native-android/platform/android/gradle/wrapper/gradle-wrapper.properties to gradle-4.4-all.zip
原因是版本不一致导致的。解决办法就是保持正确的Gradle和Android Gradle Plugin的对应关系。
Gradle和Android gradle plugin对应关系如下：
Plugin version Required Gradle version
1.0.0 - 1.1.3 2.2.1 - 2.3
1.2.0 - 1.3.1 2.2.1 - 2.9
1.5.0 2.2.1 - 2.13
2.0.0 - 2.1.2 2.10 - 2.13
2.1.3 - 2.2.3 2.14.1+
2.3.0+ 3.3+
3.0.0+ 4.1+
3.1.0+ 4.4+
解决办法：
1. 修改Gradle版本:
* 方法１：
* 在android-studio/gradle目录直接删除前一版本，如gradle-3.2.1
* 访问gradle发布地址下载新版本的gradle，如gradle-3.3。
* 解压到android-studio/gradle目录
* 方法２：
在Android Studio中打开Project Structure对话框，点击Project，指定Gradle version和Android Plugin Version。修改前需确保Gradle相应版本在目录android-studio/gradle中，Android Plugin Version相应版本在目录android-studio/gradle/m2repository/com/android/tools/build/gradle中。
验证：
在android-studio重新打开工程时，会自动生成app\gradle\wrapper\gradle-wrapper.properties文件，打开该文件进行查看：
```
#Thu Jun 07 14:46:24 CST 2018
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-3.3-all.zip
```
如果一直无法下载（说明你的网络环境有问题），可能会提示：
Error:Could not run build action using Gradle distribution 'https://services.gradle.org/distributions/gradle-4.1-all.zip'.
这是可以考虑通过浏览器下载后，放入下述文件夹：
/home/brian/.gradle/wrapper/dists/gradle-3.3-all\ //Linux
C:\Users\用户名\.gradle\wrapper\dists\gradle-3.3-all\的文件夹下（注意这里不要解压缩） //Windows
我的机器上有多个gradle版本：
```
gradle-3.2.1-all
gradle-4.1-all
gradle-4.8-all
gradle-3.3-all\55gk2rcmfc6p2dg9u9ohc3hw9\...
gradle-4.4-all
```
2. 修改Android Gradle Plugin版本
Android Gradle Plugin目录在: android-studio/gradle/m2repository/com/android/tools/build/gradle
一般有多个版本，如2.3.2/3.0.1/2.2.0
可以在build.gradle文件中指定当前工程使用的Android gradle plugin版本：
app\build.gradle文件
```
dependencies {
classpath 'com.android.tools.build:gradle:3.1.2'
}
```
中招2：版本不一致导致的其他问题
Gradle sync failed: Cannot set the value of read-only property 'outputFile' for object of type com.android.build.gradle.internal.api.LibraryVariantOutputImpl.
Could not set unknown property 'outputFileName' for object of type com.android.build.gradle.internal.api.LibraryVariantImpl.
Gradle sync failed: Cannot create variant 'android-lint' after configuration ':Map**AndroidSDK:debugRuntimeElements' has been resolved
