Gradle 笔记

• 参考 stormzhang 的 ANDROID STUDIO 系列教程四--GRADLE基础

gradle简介

简单来说，Gradle 是一种构建工具(基于 Groovy 语言)，面向 Java 应用为主。取代了以前在eclipse开发中用到的 ADT ，可以实现编译、运行、签名、打包等功能。这里主要提到gradle的依赖管理功能。

例如我们需要用到第三方库的时候，一般都是先下载 jar 文件，然后把 jar 文件添加到 libs 目录，然后项目中就可以引用了。
如果使用gradle就可以依靠一句声明来完成这个过程，

`compile 'com.facebook.stetho:stetho:1.0.1'`

我接触 Gradle 自然是因为 Android Studio 的原因，但后来才了解到他们一开始并没有直接的联系， Gradle 在 Android Studio 中是以插件的形式，在项目的根目录中 build.gradle 文件声明了。

build.gradle

相关文件

项目中存在多个 build.gradle 文件和其他的一些文件：

gradle相关文件一览

app/gradle

在这里我们可以依赖第三方库、自动打包debug，release，beta等环境，签名，多渠道打包等。

apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        applicationId "com.cmxj.zhifu"
        minSdkVersion 22
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            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.4.0'
    compile 'com.android.support:design:23.4.0'
    compile 'com.facebook.stetho:stetho:1.4.1'
    compile 'com.facebook.stetho:stetho-okhttp:1.4.1'
}

要重点注意的是 buildToolsVersion ，有时候导入项目出错就是本地下载的 gradle 的版本和项目声明的版本不一致。

关于上面的一些配置的说明：

• compileSdkVersion
  指定编译使用的 sdk 的版本，即常说的 API ，比如 API 23 对应的是 Android N。

• buildToolsVersion
  构建工具的版本，包括了 aapt、dx 等。

• minSdkVersion
  指定应用可以运行的最低 API，引用的第三库有时候也会有自己的 minSdkVersion 标示，这时候我们的 API 版本只能高于或等于库的版本。

• targetSdkVersion
  指定 Android 向前兼容的版本，这个不是特别好理解，简单说就是在运行系统会根据这里指定的 API 对代码进行检查。
  可以参考：Android targetSdkVersion 原理

• proguardFiles
  这部分有两段，前一部分代表系统默认的android程序的混淆文件，该文件已经包含了基本的混淆声明，免去了我们很多事。
  这个文件的目录在 /tools/proguard/proguard-android.txt, 后一部分是我们项目里的自定义的混淆文件，目录就在 app/proguard-rules.txt 。

../gradle

gradle-wrapper.properties 文件：

gradle-wrapper.properties

声明了gradle的目录与下载路径以及当前项目使用的gradle版本。
这个文件里指明的gradle版本不对也是很多导包不成功的原因之一。