简介
Gradle是一个优秀的构建系统和构建工具,它允许通过插件创建自定义的构建逻辑。 我们基于Gradle以下的一些特点而选择了它:
- 采用了Domain Specific Language(DSL语言)来描述和控制构建逻辑。
- 构建文件基于Groovy,并且允许通过混合声明DSL元素和使用代码来控制DSL元素以控制自定义的构建逻辑。
- 支持Maven或者Ivy的依赖管理。
- 非常灵活。允许使用最好的实现,但是不会强制实现的方式。
- 插件可以提供自己的DSL和API以供构建文件使用。
- 良好的API工具供IDE集成。
注:Android Studio的Gradle文件路径:C:\Users\用户名\.gradle\wrapper\dists。通过工具下载 “http://services.gradle.org/distributions/gradle-版本号-all.zip” 文件后,直接把zip文件放到"C:\Users\用户名\.gradle\wrapper\dists\gradle-版本号-all\串号"路径即可。
关闭android studio 重新打开 或 直接单击android studio工具栏 Sync Project Gradle Files,即可解决android studio跟新gradle错误办法
Groovy
Groovy基于Java语言,运行在JVM之上。它是一种动态语言,既可以用于面向对象编程,又可以用作纯粹的脚本语言。
Groov具有像Python, Ruby 和 Smalltalk 语言特性的灵活动态语言, Groovy保证了这些特性像 Java语法一样被 Java开发者使用。
执行Groovy脚本时,Groovy会先将其编译成Java类字节码,然后通过Jvm来执行这个Java类
基本项目
一个Gradle项目的构建过程定义在build.gradle文件中,位于项目的根目录下。
一个最简单的Gradle纯Java项目的build.gradle文件包含以下内容:
apply plugin: 'java'
这里引入了Gradle的Java插件。这个插件提供了所有构建和测试Java应用程序所需要的东西。
最简单的Android项目的build.gradle文件包含以下内容
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:0.11.1'
}
}
apply plugin: 'android'
android {
compileSdkVersion 19
buildToolsVersion "19.0.0"
}
buildscrip{...}这里配置了驱动构建过程的代码。
在这个部分,它声明了使用Maven仓库,并且声明了一个maven文件的依赖路径。这个文件就是包含了0.11.1版本android gradle插件的库。
注意:这里的配置只影响控制构建过程的代码,不影响项目源代码。项目本身需要声明自己的仓库和依赖关系,稍后将会提到这部分。
接下来,跟前面提到的Java Plugin一样添加了android plugin。
最后,andorid{...}配置了所有android构建过程需要的参数。这里也是Android DSL的入口点。
默认情况下,只需要配置目标编译SDK版本和编译工具版本,即compileSdkVersion和buildToolsVersion属性。 这个complieSdkVersion属性相当于旧构建系统中project.properites文件中的target属性。这个新的属性可以跟旧的target属性一样指定一个int或者String类型的值。
重要:你只能添加android plugin。同时添加java plugin会导致构建错误。
注意:你同样需要在相同路径下添加一个local.properties文件,并使用sdk.dir属性来设置SDK路径。 另外,你也可以通过设置ANDROID_HOME环境变量,这两种方式没有什么不同,根据你自己的喜好选择其中一种设置。
工程中每个子模块(Library或者Application)都是一个单独的gradle编译的project。每个project在其根目录下都必须有一个build.gradle,该文件是project的编译脚本。
由于一个工程可能有多个子模块组成,gradle需要支持Multi-Projects Build,即同时编译多个project。在工程的根目录下添加一个build.gradle即可,该文件用来配置其他的子project。更重要的是在工程的根目录下添加settings.gradle,该文件记录了工程包含多少个子project。settings.gradle除了可以include外,还可以设置一些函数。这些函数会在gradle构建整个工程任务的时候执行,所以,可以在settings做一些初始化的工作。
//settings.gradle示例
include ':app', ':commonmodule', ':moudlea', ':moudlec'
Android Studio的Terminal,可以执行gradle命令。e.g. gradlew projects, gradlew <project-path>:tasks,gradlew tasks --all等
项目结构
基本的项目开始于两个名为“source sets”的组件,即main source code和test code。它们分别位于:
- src/main/
-
src/androidTest/
里面每一个存在的文件夹对应相应的源组件。
对于Android plugin来说,常见的文件和文件夹结构如下:
构建任务
General Tasks(通用任务)
添加一个插件到构建文件中将会自动创建一系列构建任务(build tasks)去执行(注:gradle属于任务驱动型构建工具,它的构建过程是基于Task的)。Java plugin和Android plugin都会创建以下task:
- assemble 这个task将会组合项目的所有输出。
- check 这个task将会执行所有检查。
- build 这个task将会执行assemble和check两个task的所有工作
- clean 这个task将会清空项目的输出。
实际上assemble,check,build这三个task不做任何事情。它们只是一个Task标志,用来告诉android plugin添加实际需要执行的task去完成这些工作。
这就允许你去调用相同的task,而不需要考虑当前是什么类型的项目,或者当前项目添加了什么plugin。 例如,添加了findbugs plugin将会创建一个新的task并且让check task依赖于这个新的task。当check task被调用的时候,这个新的task将会先被调用。
注意:Gradle会自动监视一个task声明的所有输入和输出。 两次执行build task并且期间项目没有任何改动,gradle将会使用UP-TO-DATE通知所有task。这意味着第二次build执行的时候不会请求任何task执行。这允许task之间互相依赖,而不会导致不需要的构建请求被执行。
Android tasks
Android plugin使用相同的约定以兼容其他插件,并且附加了自己的标识性task,包括:
- assemble 这个task将会组合项目的所有输出。
- check 这个task将会执行所有检查。
- build 这个task将会执行assemble和check两个task的所有工作
- clean 这个task将会清空项目的输出。
- connectedCheck 这个task将会在一个指定的设备或者模拟器上执行检查,它们可以同时在所有连接的设备上执行。
- deviceCheck 通过APIs连接远程设备来执行检查,这是在CL服务器上使用的。
这些新的标识性task是必须的,以保证能够在没有设备连接的情况下执行定期检查。 注意build task不依赖于deviceCheck或者connectedCheck。
一个Android项目至少拥有两个输出:debug APK(调试版APK)和release APK(发布版APK)。每一个输出都拥有自己的标识性task以便能够单独构建它们。
- assemble
- assembleDebug
- assembleRelease
它们都依赖于其它一些tasks以完成构建一个APK需要多个步骤。其中assemble task依赖于这两个task,所以执行assemble将会同时构建出两个APK。
gradle在命令行终端上支持骆驼命名法的task简称,例如,执行gradle aR命令等同于执行gradle assembleRelease。
check task也拥有自己的依赖:
- check
- lint
- connectedCheck
- connectedAndroidTest
- connectedUiAutomatorTest(目前还没有应用到)
- deviceCheck
- 这个test依赖于test创建时,其它实现测试扩展点的插件。
参考文章:
http://blog.csdn.net/innost/article/details/48228651
http://www.groovy-lang.org/api.html groovy语法