初步了解Gradle

//-- Task 任务
//-- plugin插件
//–Gradle 小秘书
一、什么是Gradle
Gradle是一个构建工具&＃xff0c;它是用来帮助我们构建app的&＃xff0c;构建包括编译、打包等过程。我们可以为Gradle指定构建规则&＃xff0c;然后它就会根据我们的“命令”自动为我们构建app。Android Studio中默认就使用Gradle来完成应用的构建。

有些时候&＃xff0c;我们会有一些个性化的构建需求&＃xff0c;比如我们引入了第三方库&＃xff0c;或者我们想要在通用构建过程中做一些其他的事情&＃xff0c;这时我们就要自己在系统默认构建规则上做一些修改。这时候我们就要自己向Gradle”下命令“了&＃xff0c;这时候我们就需要用Gradle能听懂的话了&＃xff0c;也就是Groovy。Groovy是一种基于JVM的动态语言。

我们在开头处提到“Gradle是一种构建工具”。实际上&＃xff0c;当我们想要更灵活的构建过程时&＃xff0c;Gradle就成为了一个编程框架——我们可以通过编程让构建过程按我们的意愿进行。
当我们把Gradle作为构建工具使用时&＃xff0c;我们只需要掌握它的配置脚本的基本写法就OK了&＃xff1b;而当我们需要对构建流程进行高度定制时&＃xff0c;就务必要掌握Groovy等相关知识了。

二、Gradle的基本组分

1. Project与Task
   在Gradle中&＃xff0c;每一个待构建的工程是一个Project&＃xff0c;构建一个Project需要执行一系列Task&＃xff0c;比如编译、打包这些构建过程的子过程都对应着一个Task。具体来说&＃xff0c;一个apk文件的构建包含以下Task&＃xff1a;Java源码编译、资源文件编译、Lint检查、打包以生成最终的apk文件等等。

2. 插件
   插件的核心工作有两个&＃xff1a;一是定义Task&＃xff1b;二是执行Task。也就是说&＃xff0c;我们想让Gradle能正常工作&＃xff0c;完成整个构建流程中的一系列Task的执行&＃xff0c;必须导入合适的插件&＃xff0c;这些插件中定义了构建Project中的一系列Task&＃xff0c;并且负责执行相应的Task。
   在新建工程的app模块的build.gradle文件的第一行&＃xff0c;往往都是如下这句&＃xff1a;
   apply plugin: ‘com.android.application’
   这句话的意思就是应用“com.android.application“这个插件来构建app模块&＃xff0c;app模块就是Gradle中的一个Project。也就是说&＃xff0c;这个插件负责定义并

执行Java源码编译、资源文件编译、打包等一系列Task。实际上"com.android.application"整个插件中定义了如下4个顶级任务&＃xff1a;
assemble: 构建项目的输出&＃xff08;apk&＃xff09;
check: 进行校验工作
build: 执行assemble任务与check任务
clean: 清除项目的输出

当我们执行一个任务时&＃xff0c;会自动执行它所依赖的任务。比如&＃xff0c;执行assemble任务会执行assembleDebug任务和assembleRelease任务&＃xff0c;这是因为一个Android项目至少要有debug和release这两个版本的输出。

3. Gradle配置文件
   
   上面我们说过&＃xff0c;Android Studio中的一个Module即为Gradle中的一个Project。上图的app目录下&＃xff0c;存在一个build.gradle文件&＃xff0c;代表了app Module的构建脚本&＃xff0c;它定义了应用于本模块的构建规则。我们可以看到&＃xff0c;工程根目录下也存在一个build.gradle文件&＃xff0c;它代表了整个工程的构建&＃xff0c;其中定义了适用于这个工程中所有模块的构建规则。

接下来我们介绍一下上图中其他几个Gradle配置文件&＃xff1a;
gradle.properties: 从它的名字可以看出&＃xff0c;这个文件中定义了一系列“属性”。实际上&＃xff0c;这个文件中定义了一系列供build.gradle使用的常量&＃xff0c;比如keystore的存储路径、keyalias等等。

gradlew与gradlew.bat: gradlew为Linux下的shell脚本&＃xff0c;gradlew.bat是Windows下的批处理文件。gradlew是gradle wrapper的缩写&＃xff0c;也就是说它对gradle的命令进行了包装&＃xff0c;比如我们进入到指定Module目录并执行“gradlew.bat assemble”即可完成对当前Module的构建&＃xff08;Windows系统下&＃xff09;。

local.properties: 从名字就可以看出来&＃xff0c;这个文件中定义了一些本地属性&＃xff0c;比如SDK的路径。

settings.gradle: 假如我们的项目包含了不只一个Module时&＃xff0c;我们想要一次性构建所有Module以完成整个项目的构建&＃xff0c;这时我们需要用到这个文件。

比如我们的项目包含了ModuleA和ModuleB这两个模块&＃xff0c;则这个文件中会包含这样的语句&＃xff1a;include ‘:ModuleA’, ‘:ModuleB’。

4. 构建脚本
   首先我们来看一下工程目录下的build.gradle&＃xff0c;它指定了真个整个项目的构建规则&＃xff0c;它的内容如下&＃xff1a;

buildscript {repositories {jcenter() //构建脚本中所依赖的库都在jcenter仓库下载}dependencies {//指定了gradle插件的版本classpath &＃39;com.android.tools.build:gradle:1.5.0&＃39;}
}allprojects {repositories {//当前项目所有模块所依赖的库都在jcenter仓库下载jcenter()}
}

我们再来简单介绍下app模块的build.gradle的内容&＃xff1a;

//加载用于构建Android项目的插件
apply plugin: &＃39;com.android.application&＃39;android { //构建Android项目使用的配置compileSdkVersion 23 //指定编译项目时使用的SDK版本buildToolsVersion "23.0.1" //指定构建工具的版本defaultConfig {applicationId "com.absfree.debugframwork" //包名minSdkVersion 15 //指定支持的最小SDK版本targetSdkVersion 23 //针对的目标SDK版本versionCode 1 versionName "1.0"}buildTypes { //针对不同的构建版本进行一些设置release { //对release版本进行的设置minifyEnabled false //是否开启混淆proguardFiles getDefaultProguardFile(&＃39;proguard-android.txt&＃39;), &＃39;proguard-rules.pro&＃39; //指定混淆文件的位置}}
}dependencies { //指定当前模块的依赖compile fileTree(dir: &＃39;libs&＃39;, include: [&＃39;*.jar&＃39;])testCompile &＃39;junit:junit:4.12&＃39;compile &＃39;com.android.support:appcompat-v7:23.1.1&＃39;compile &＃39;com.android.support:design:23.1.1&＃39;
}


三、常见配置
整个工程的build.gradle通常不需我们改动&＃xff0c;这里我们介绍下一些对模块目录下build.gradle文件的常见配置。

1. 依赖第三方库
   当我们的项目中用到了了一些第三方库时&＃xff0c;我们就需要进行一些配置&＃xff0c;以保证能正确导入相关依赖。设置方法很简单&＃xff0c;比如我们在app模块中中用到了Fresco&＃xff0c;只需要在build.gradle文件中的dependencies块添加如下语句&＃xff1a;

dependencies {...compile &＃39;com.facebook.fresco:fresco:0.11.0&＃39;
}


这样一来&＃xff0c;Gradle会自动从jcenter仓库下载我们所需的第三方库并导入到项目中。
2.导入本地jar包
在使用第三方库时&＃xff0c;除了像上面那样从jcenter仓库下载&＃xff0c;我们还可以导入本地的jar包。配置方法也很简单&＃xff0c;只需要先把jar文件添加到app\libs目录下&＃xff0c;然后在相应jar文件上单击右键&＃xff0c;选择“Ad As Library”。然后在build.gradle的dependencies块下添加如下语句&＃xff1a;
compile files(‘libs/xxx.jar’)
实际上我们可以看到&＃xff0c;系统为我们创建的build.gradle中就已经包含了如下语句&＃xff1a;
compile fileTree(dir: ‘libs’, include: [’*.jar’])
这句话的意思是&＃xff0c;将libs目录下的所有jar包都导入。所以实际上我们只需要把jar包添加到libs目录下并“Ad As Library"即可。
3. 依赖其它模块
假设我们的项目包含了多个模块&＃xff0c;并且app模块依赖other模块&＃xff0c;那么我们只需app\build.gradle的denpendencies块下添加如下语句&＃xff1a;
compile project(’:other’)
4. 构建输出为aar文件
通常我们构建的输出目标都是apk文件&＃xff0c;但如果我们的当前项目时Android Library&＃xff0c;我们的目标输出就是aar文件。要想达到这个目的也很容易&＃xff0c;只需要把build.gradle的第一句改为如下&＃xff1a;
apply plugin:‘com.android.library’
这话表示我们使用的插件不再是构建Android应用的插件&＃xff0c;而是构建Android Library的插件&＃xff0c;这个插件定义并执行用于构建Android Library的一系列Task。
5. 自动移除不再使用的资源
只需进行如下配置&＃xff1a;

android {...}buildTypes {release {...shrinkResources true...}}
}


6. 忽略Lint错误
   在我们构建Android项目的过程中&＃xff0c;有时候会由于Lint错误而终止。当这些错误来自第三方库中时&＃xff0c;我们往往想要忽略这些错误从而继续构建进程。这时候&＃xff0c;我们可以只需进行如下配置&＃xff1a;

android {...lintOptions {abortOnError false}
}


7. 集成签名配置
   在构建release版本的Android项目时&＃xff0c;每次都手动导入签名文件&＃xff0c;键入密码、keyalias等信息十分麻烦。通过将签名配置集成到构建脚本中&＃xff0c;我们就不必每次构建发行版本时都手动设置了。具体配置如下&＃xff1a;

signingConfigs {myConfig { //将"xx"替换为自己的签名文件信息storeFile file("xx.jks")storePassword "xx"keyAlias "xx"keyPassword "xx"}
}
android {buildTypes {release {signingConfig signingConfigs.myConfig //在release块中加入这行...}}...
}


真实开发中&＃xff0c;我们不应该把密码等信息直接写到build.gradle中&＃xff0c;更好的做法是放在gradle.properties中设置&＃xff1a;

RELEASE_STOREFILE&＃61;xxx.jks
RELEASE_STORE_PASSWORD &＃61; xxx
RELEASE_KEY_ALIAS&＃61;xxx
RELEASE_KEY_PASSWORD&＃61;xxx
然后在build.gradle中直接引用即可&＃xff1a;
signingConfigs {myConfig { storeFilefile(RELEASE_STOREFILE)storePassword RELEASE_STORE_PASSWORDkeyAlias RELEASE_KEY_ALIASkeyPassword RELEASE_KEY_PASSWORD }
}


&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;
四、延伸阅读

1. 深入理解Android之Gradle:http://blog.csdn.net/Innost/article/details/48228651
   邓凡平老师的一篇博文&＃xff0c;从原理到使用非常深入细致地介绍了Gradle。而且重点介绍了怎样把Gradle当做一个编程框架来使用&＃xff0c;介绍了Groovy语法基础、Gradle常用API&＃xff0c;想要高度定制项目构建过程的小伙伴们一定不要错过这篇文章哦&＃xff1a;&＃xff09;

2. Gradle构建最佳实践: http://www.figotan.org/2016/04/01/gradle-on-android-best-practise/
   这篇文章主要从使用者的角度介绍了Gradle在使用过程中的最佳实践&＃xff0c;同样非常精彩。