快速掌握 Android Studio 中 Gradle 的使用方法

Gradle是可以用于Android开发的新一代的Build System， 也是 Android Studio默认的build工具。

Gradle脚本是基于一种JVM语言 -- Groovy，再加上DSL（领域特定语言）组成的。

因为Groovy是JVM语言，所以可以使用大部分的Java语言库。所谓DSL就是专门针对Android开发的插件，比如标准Gradle之外的一些新的方法（Method）、闭包（Closure）等。

由于Gradle的语法足够简洁，而且可以使用大部分的java包，当之无愧地成为新一代 Build System。

使用Android Studio新建一个工程后，默认会生成两个build.gralde文件，一个位于工程根目录，一个位于app目录下。还有另外一个文件 --settings.gradle。

根目录下的脚本文件是针对module的全局配置，它的作用阈所包含的所有 module 是通过settings.gradle来配置。

app文件夹就是一个module，如果在当前工程中添加了一个新的module -- lib，就需要在settings.gralde文件中包含这个新的module。

gradle脚本的基本结构

用我现在的工程举例来说，根目录的build.gradle的内容如下所示：

<span style="font-size:14px;">
buildscript {  
    repositories {  
        jcenter()  
    }  
    dependencies {  
        classpath 'com.android.tools.build:gradle:1.0.0-rc4'  
  
        // NOTE: Do not place your application dependencies here; they belong  
        // in the individual module build.gradle files  
    }  
}  
  
allprojects {  
    repositories {  
        jcenter()  
  
        maven {  
            url 'http://mvnrepo.xxx.com/mvn/repository'  
        }  
    }  
}

</span>

classpath 'com.android.tools.build:gradle:1.0.0-rc4'就是Android特有的插件，maven仓库位于通过方法jCenter() 获取，这也是默认的maven仓库。当然也可以添加额外的maven仓库地址，例如以上文件中的

maven {
    url 'http://mvnrepo.xxx.com/mvn/repository'
}

然后是 settings.gradle 文件：

include ':app' 

app就是项目包含的一个module，如果有多个module，可以在为 include 方法添加多个参数。

最后是app/build.gradle

    apply plugin: 'com.android.application'  
      
    android {  
        compileSdkVersion 21  
        buildToolsVersion "21.1.1"  
      
        compileOptions {  
            sourceCompatibility JavaVersion.VERSION_1_7  
            targetCompatibility JavaVersion.VERSION_1_7  
        }  
      
      
        defaultConfig {  
            applicationId "your.application.id"  
            minSdkVersion 14  
            targetSdkVersion 21  
            versionCode 2  
            versionName "2.0.0"  
        }  
      
        signingConfigs {  
            release {  
                storeFile file('release.keystore')  
                storePassword "yourstorepassword"  
                keyAlias "yourkeyalias"  
                keyPassword "yourkeypassword"  
            }  
            debug {  
                storeFile file('debug.keystore')  
            }  
        }  
      
        buildTypes {  
            release {  
                minifyEnabled true  
                proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'  
                signingConfig signingConfigs.release  
            }  
            debug {  
                signingConfig signingConfigs.debug  
            }  
        }  
      
        productFlavors {  
            inner {  
                applicationId "your.application.inner.id"  
                versionName "2.0.0"  
            }  
      
            market {  
      
            }  
        }  
    }  
      
    repositories {  
        flatDir {  
            dirs 'libs'  
        }  
    }  
      
    dependencies {  
      
        // 通用  
        compile name: 'volley', ext: 'aar'  
        compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.3'  
        compile 'com.alibaba:fastjson:latest.integration'  
      
        // 项目相关（已删除）  
    }  

这里需要说明几点：

• 文件开头apply plugin是最新gradle版本的写法，以前的写法是apply plugin: 'android', 如果还是以前的写法，请改正过来。

• buildToolsVersion这个需要你本地安装该版本才行，很多人导入新的第三方库，失败的原因之一是build version的版本不对，这个可以手动更改成你本地已有的版本或者打开 SDK Manager 去下载对应版本。

• applicationId代表应用的包名，也是最新的写法，这里就不在多说了。

• android 5.0开始默认安装jdk1.7才能编译，但是由于mac系统自带jdk的版本是1.6，所以需要手动下载jdk1.7并配置下。

• proguardFiles这部分有两段，前一部分代表系统默认的android程序的混淆文件，该文件已经包含了基本的混淆声明，免去了我们很多事，这个文件的目录在 <sdk目录>/tools/proguard/proguard-android.txt , 后一部分是我们项目里的自定义的混淆文件，目录就在 app/proguard-rules.txt , 如果你用Studio 1.0创建的新项目默认生成的文件名是 proguard-rules.pro , 这个名字没关系，在这个文件里你可以声明一些第三方依赖的一些混淆规则。

• compile project(':extras:ShimmerAndroid')这一行是因为9GAG中存在其他Module，不知道Module的概念可以看下这篇博客Android Studio系列教程二--基本设置与运行, 总之你可以理解成Android Library，由于Gradle的普及以及远程仓库的完善，这种依赖渐渐的会变得非常不常见，但是你需要知道有这种依赖的。

• 以上文件里的内容只是基本配置，其实还有很多自定义部分，如自动打包debug，release，beta等环境，签名，多渠道打包等。

Groovy 的基本语法

方法调用

apply plugin: 'com.android.application'  

以上语句中的apply是一个方法，给它传递了一个参数plugin，plugin 的值是'com.android.application'。

如果有多个参数，则以逗号隔开，例如

compile name: 'volley', ext: 'aar'

闭包

Groovy中花括号包含的部分成为一个闭包（Closure）。例如下面的代码

compileOptions {  
    sourceCompatibility JavaVersion.VERSION_1_7  
    targetCompatibility JavaVersion.VERSION_1_7  
} 

compileOptions 是一个 Method， 它的参数是一个闭包，这个闭包内依次执行了两个方法 -- sourceCompatibility 和targetCompatibility， 参数都是JavaVersion.VERSION17。

闭包也可以嵌套包含

    repositories {  
        flatDir {  
            dirs 'libs'  
        }  
    }  

常见使用方法

包依赖（aar）

使用aar时可以分为两种情况

① aar位于本地目录

1. 首先在 android 的参数闭包中添加调用方法 repositories

    repositories {  
       flatDir {  
           dirs 'libs'  
       }  
    } 

   
   

2. 然后在 dependencies 的参数闭包中添加

   compile name: 'volley', ext: 'aar'  

   
   
   

② aar位于远程仓库

这里以maven为例，当然也可以使用其他类型的仓库，例如 Ivy。

只需要在jar包引用方式后面添加一个@aar就可以了

compile 'com.alibaba:fastjson:latest.integration@aar' 

包依赖（jar）

compile group: 'com.alibaba', module: 'fastjson', version: 'latest.integration'  

可以简写成

compile 'com.alibaba:fastjson:latest.integration'  

latest.integration可以替换成具体的版本号，这里是获取服务器上的最新版本。

去掉重复依赖

compile 'com.alibaba.fastjson.latest.integration' {  
    exclude module: 'annotations', group: 'com.google.android'  
} 

使用 Java7

    compileOptions {  
        sourceCompatibility JavaVersion.VERSION_1_7  
        targetCompatibility JavaVersion.VERSION_1_7  
    }  

productFlavors

针对不同的APP分发渠道，我们可以定义不同的 product flavor。也可以定义内部版本和外部版本，内部版本中包含了一些调试代码，这些代码在发布时并不会被编译进最后的APP中。而且可以分别为内部版本和外部版本指定不同的ApplicationId，这样在同一个设备上可以同时安装两个版本以方便调试。

命令行执行Gradle脚本

在Android工程根目录下会自动生成一个shell脚本 - gradlew，执行之前记得加上x属性 - chomod +x gradlew

gradle脚本中包含了很多 task，可以通过task名来指定需要执行的task。

• ./gradlew build
• ./gradlew assemble
• ./gradlew assembleInnderDebug

总结

不得不说，Gradle实在太好用了！虽然 Gradle 可以与 Ant 或 maven 配合使用，但是其简洁和功能性远远超过其他两个。我现在开发的项目普遍使用的是 maven，不知道什么原因，使用Gradle时经常会遇到一些无法获取远程依赖包的问题，最简单的解决办法就是把依赖包下载的本地。