<p>使用 Android Studio 来开发 Android 工程的过程中，接触 Gradle 是不可避免的，比如配置签名、引入依赖等。那么 Gradle 到底是什么东西呢？ Gradle 是一个基于 Apache Ant 和 Apache Maven 概念的项目自动化建构工具。它使用一种基于 Groovy 的特定领域语言 (DSL) 来声明项目设置，抛弃了基于 XML 的各种繁琐配置 (此定义来自于百度百科-_- !) 。啰里啰唆一堆，幸运的是，一般来说 Android 开发者只要会配置 Gradle 就可以了，并不需要深入了解。那么下面我们就来揭开 Gradle 的面纱吧。</p>    <h2><strong>Gradle 配置</strong></h2>    <p>首先贴出一张自己项目的文件目录结构图：</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/dd81e5ec2c95d561befe25313cc012a2.png"></p>    <p>从上图中我们可以看到，与 Gradle 有关的文件基本上分为四种：</p>    <ol>     <li>app 下的 build.gradle (当然其他 module 下也有)；</li>     <li>根目录下的 gradle 文件夹；</li>     <li>根目录下的 build.gradle ；</li>     <li>根目录下的 settings.gradle ；</li>    </ol>    <p>也许有人会说根目录下还有一个 config.gradle 文件呢，其实这是我自定义的 gradle 文件，自定义 Gradle 文件会在下面中讲解，这里先搁置一下。好了，那么我们一个一个地来看看他们的作用吧。</p>    <h2>app 下的 build.gradle</h2>    <pre>  <code class="language-groovy">apply plugin: 'com.android.application'  android {      compileSdkVersion 23 // 编译sdk版本      buildToolsVersion "23.0.2" // 构建工具版本      defaultConfig {          applicationId "com.yuqirong.koku" // 应用包名          minSdkVersion 15 // 最低适用sdk版本          targetSdkVersion 23 // 目标sdk版本          versionCode 1 // 版本号          versionName "1.0" // 版本名称      }      buildTypes {          release {              minifyEnabled true // 开启混淆              zipAlignEnabled true // 对齐zip              shrinkResources false // 删除无用资源              debuggable false // 是否debug              versionNameSuffix "_release" // 版本命名后缀              proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' // 混淆文件          }            debug {              zipAlignEnabled false              shrinkResources false              minifyEnabled false              versionNameSuffix "_debug"              signingConfig signingConfigs.debug              proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'          }      }  }  dependencies {      compile fileTree(dir: 'libs', include: ['*.jar'])      testCompile 'junit:junit:4.12'      compile 'com.android.support:appcompat-v7:23.2.1'      compile 'com.android.support:design:23.2.1'  }</code></pre>    <p>第一句 apply plugin: 'com.android.application' 主要用来申明这是一个 Android 程序。而 dependencies 用于引入依赖，这个相信大家都比较了解了。其他的配置比较简单都有注释，就不展开讲了。</p>    <p>当然除了上面的配置之外，还有很多配置也常常写入到 app/build.gradle 中。我们慢慢往下看。</p>    <ul>     <li> <p>签名配置：</p> </li>    </ul>    <pre>  <code class="language-groovy">signingConfigs {         release { // 正式版本的签名          storeFile file("../koku.jks") // 密钥文件位置          storePassword "xxxxxxxxx" // 密钥密码          keyAlias "koku" // 密钥别名          keyPassword "xxxxxxxxx" // 别名密码      }         debug { // debug版本的签名          // no keystore      }  }  </code></pre>    <p>使用时只要在 buildTypes 的 release 中加一句 signingConfig signingConfigs.release 就好了。</p>    <p>如果你觉得把密钥密码和别名密码放在 app/build.gradle 里不安全，那么可以把相关密码放到不加入版本控制系统的 gradle.properties 文件：</p>    <pre>  <code class="language-groovy">KEYSTORE_PASSWORD=xxxxxxxxxx  KEY_PASSWORD=xxxxxxxxx</code></pre>    <p>对应的 signingConfigs 配置：</p>    <pre>  <code class="language-groovy">signingConfigs {      release {          try {              storeFile file("../koku.jks")              storePassword KEYSTORE_PASSWORD              keyAlias "koku"              keyPassword KEY_PASSWORD          }          catch (ex) {              throw new InvalidUserDataException("You should define KEYSTORE_PASSWORD and KEY_PASSWORD in gradle.properties.")          }      }  }  </code></pre>    <ul>     <li> <p>Java 编译版本配置：</p> </li>    </ul>    <pre>  <code class="language-groovy">compileOptions { // java 版本      sourceCompatibility JavaVersion.VERSION_1_8      targetCompatibility JavaVersion.VERSION_1_8  }  </code></pre>    <p>这里需要注意下，如果 Java 编译版本为1.8的话，另外在 defaultConfig 里要配置 Jack 编译器：</p>    <pre>  <code class="language-groovy">jackOptions {      enabled true  }  </code></pre>    <ul>     <li> <p>Lint 检查配置：</p> </li>    </ul>    <pre>  <code class="language-groovy">lintOptions {      abortOnError false // 是否忽略lint报错  }  </code></pre>    <ul>     <li> <p>多渠道信息配置：</p> </li>    </ul>    <pre>  <code class="language-groovy">productFlavors {      xiaomi {}      googleplay {}      wandoujia {}  }  </code></pre>    <p>整个 app/build.gradle 文件配置如下所示：</p>    <pre>  <code class="language-groovy">apply plugin: 'com.android.application'    android {      compileSdkVersion rootProject.ext.android.compileSdkVersion      buildToolsVersion rootProject.ext.android.buildToolsVersion      defaultConfig {          applicationId "com.yuqirong.koku" // 应用包名          minSdkVersion 15 // 最低适用sdk版本          targetSdkVersion 23 // 目标sdk版本          versionCode 1 // 版本号          versionName "1.0" // 版本名称          testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"          // 默认是umeng的渠道          manifestPlaceholders = [UMENG_CHANNEL_VALUE: "umeng"]          jackOptions {              enabled true          }      }      java 版本      compileOptions {          sourceCompatibility JavaVersion.VERSION_1_8          targetCompatibility JavaVersion.VERSION_1_8      }      signingConfigs {          release {              storeFile file("../koku.jks")              storePassword "xxxxxx"              keyAlias "koku"              keyPassword "xxxxxx"          }          debug {              // no keystore          }      }      buildTypes {          release {              // 开启混淆              minifyEnabled true              // 对齐zip              zipAlignEnabled true              // 删除无用资源              shrinkResources false              // 是否debug              debuggable false              // 命名后缀              versionNameSuffix "_release"              // 签名              signingConfig signingConfigs.release              proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'              applicationVariants.all { variant ->                  variant.outputs.each { output ->                      def outputFile = output.outputFile                      if (outputFile != null && outputFile.name.endsWith('.apk')) {                          // 输出apk名称为koku_v1.0_2015-01-15_wandoujia.apk                          def fileName = "koku_v${defaultConfig.versionName}_${releaseTime()}_${variant.productFlavors[0].name}.apk"                          output.outputFile = new File(outputFile.parent, fileName)                      }                  }              }          }            debug {              zipAlignEnabled false              shrinkResources false              minifyEnabled false              versionNameSuffix "_debug"              signingConfig signingConfigs.debug              proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'          }      }      lintOptions {          abortOnError false      }      productFlavors {          xiaomi {}          googleplay {}          wandoujia {}      }      //针对很多渠道      productFlavors.all {          flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]      }  }    dependencies {      compile fileTree(dir: 'libs', include: ['*.jar'])      testCompile 'junit:junit:4.12'      compile 'com.android.support:appcompat-v7:23.2.1'      compile 'com.android.support:design:23.2.1'  }    def releaseTime() {      return new Date().format("yyyy-MM-dd", TimeZone.getTimeZone("UTC"))  }  </code></pre>    <p>再多嘴一句，有了以上的 build.gradle 配置之后，如果想使用 Gradle 多渠道打包，需要在 AndroidManifest.xml 中申明：</p>    <pre>  <code class="language-groovy"><meta-data android:name="UMENG_CHANNEL" android:value="${UMENG_CHANNEL_VALUE}" />  </code></pre>    <p>最后使用命令 gradlew assembleRelease 打包即可。</p>    <h2><strong>根目录下的 gradle 文件夹</strong></h2>    <p>gradle 文件夹中主要是 gradle-wrapper.properties 文件比较重要，主要用来声明 Gradle 目录以及 Gradle 下载路径等：</p>    <pre>  <code class="language-groovy">distributionBase=GRADLE_USER_HOME  distributionPath=wrapper/dists  zipStoreBase=GRADLE_USER_HOME  zipStorePath=wrapper/dists  distributionUrl=https\://services.gradle.org/distributions/gradle-2.14.1-all.zip  </code></pre>    <h2><strong>根目录下的 build.gradle</strong></h2>    <p>根目录下的 build.gradle 主要作用就是定义项目中公共属性，比如有依赖仓库、 Gradle 构建版本等：</p>    <pre>  <code class="language-groovy">buildscript {      repositories {          jcenter()      }      dependencies {          classpath 'com.android.tools.build:gradle:2.2.1'          // NOTE: Do not place your application dependencies here; they belong          // in the individual module build.gradle files      }  }    allprojects {      repositories {          jcenter()          mavenCentral()      }  }    task clean(type: Delete) {      delete rootProject.buildDir  }  </code></pre>    <h2><strong>setting.gradle</strong></h2>    <p>setting.gradle 的作用就是一些模块被包含后，会在这里进行申明：</p>    <pre>  <code class="language-groovy">include ':app'  </code></pre>    <h2><strong>自定义 Gradle 文件</strong></h2>    <p>在上面我们留了一个悬念，就是如何添加我们自定义的 Gradle 文件。接下来我们就动手来实践一下。在项目根目录下创建文件 config.gradle 。然后在根目录下的 build.gradle 开头添加一句 apply from: "config.gradle" ：</p>    <pre>  <code class="language-groovy">apply from: "config.gradle"    buildscript {      repositories {          jcenter()      }   ...  }    ...  </code></pre>    <p>这句话就代表着把 config.gradle 添加进来了。然后我们可以在 config.gradle 中申明一些配置：</p>    <pre>  <code class="language-groovy">ext {        android = [   compileSdkVersion: 23,   buildToolsVersion: "23.0.3",              applicationId : "com.yuqirong.koku",              minSdkVersion : 14,              targetSdkVersion : 23,              versionCode : 3,              versionName : "1.4"      ]        dependencies = [              "appcompat-v7"            : 'com.android.support:appcompat-v7:23.0.1',              "recyclerview-v7"         : 'com.android.support:recyclerview-v7:24.2.1',              "design"                  : 'com.android.support:design:23.0.1'      ]  }  </code></pre>    <p>最后在 app/build.gradle 中去使用：</p>    <pre>  <code class="language-groovy">android {      compileSdkVersion rootProject.ext.android.compileSdkVersion      buildToolsVersion rootProject.ext.android.buildToolsVersion      defaultConfig {          applicationId rootProject.ext.android.applicationId          minSdkVersion rootProject.ext.android.minSdkVersion          targetSdkVersion rootProject.ext.android.targetSdkVersion          versionCode rootProject.ext.android.versionCode          versionName rootProject.ext.android.versionName            jackOptions {              enabled true          }      }   ...  }    dependencies {      compile fileTree(dir: 'libs', include: ['*.jar'])      compile rootProject.ext.dependencies["appcompat-v7"]      compile rootProject.ext.dependencies["recyclerview-v7"]      compile rootProject.ext.dependencies["design"]  }  </code></pre>    <p>从上面可以看到，我们把一些固定的配置“拎”出来放到 config.gradle 中，这样以后直接更改 config.gradle 就行了，方便多人协作开发。</p>    <h2><strong>结束</strong></h2>    <p>关于 Gradle 的平时经常使用方法基本上就上面这些了。其他的一些比如 buildConfigField 之类的可以自行百度，相信聪明的你很快就会了。但是 Gradle 并没有以上讲得那么简单，还需要童鞋们继续努力学习了。</p>    <h2><strong>References</strong></h2>    <ul>     <li><a href="/misc/goto?guid=4959721965196077794" rel="nofollow,noindex">给 ANDROID 初学者的 GRADLE 知识普及</a></li>     <li><a href="/misc/goto?guid=4959721965280167859" rel="nofollow,noindex">ANDROID 开发你需要了解的 GRADLE 配置</a></li>    </ul>    <p> </p>    <p>来自：http://yuqirong.me/2016/10/23/关于Gradle配置的小结/</p>    <p> </p>