参考一
参考二
一:Gradle概念:Gradle是一种依赖管理工具,基于Groovy语言,它抛弃了基于XML的各种繁琐配置,取而代之的是一种基于Groovy的内部领域特定(DSL)语言。
二:Gradle组成:项目(Project) 和 任务(tasks)
项目(Project) :构建产物(比如Jar包)或实施产物(将应用程序部署到生产环境)。
任务(tasks):指不可分的最小工作单元,执行构建工作(比如编译项目或执行测试)。
每一个构建都是由一个或多个 projects 构成的,每一个 project 是由一个或多个 tasks 构成的。
三:Gradle构建系统文件的组成
build.gradle: 这个脚本定义了一个模块和编译用的tasks,它一般是放在项目的模块中,也可以放在项目的根目录用来作为编译结构全局设置,必须具有
settings.gradle: 描述了哪一个模块需要参与构建。每一个多模块的构建都必须在项目结构的根目录中加入这个设置文件,是必须具有的
gradle.properties :用来配置构建属性,不是必须具有的
四:定义Task
定义一个task
task hello {
doLast {
println 'Hello world!'
}
}
在win cmd命令行下运行gradle hello,输出
对于上面task简化形势
task hello<<{
println "Hello world"
}
<< 就等价于 doLast,doLast 是gradle提供访问task任务的一个API,类似的还有 doFirst,当一个task被执行的时候,可以通过 doFirst和 doLast向task中动态添加操作。
doFirst和doLast会在task本身被执行之后才会被执行。
例如:
task hello {
println 'Hello Earth'
}
hello.doFirst {
println 'Hello Venus'
}
hello.doFirst {
println 'Hello Mercury'
}
hello.doLast {
println 'Hello Mars'
}
hello << {
println 'Hello Jupiter'
}
输出结果:
五: 动态创建Task
创建Task0,Task1,Task2,Task3.
4.times { counter ->
task "task$counter" << {
println "I'm task number $counter"
}
}
通过API访问一个任务 - 加入一个依赖
4.times { counter ->
task "task$counter" << {
println "I'm task number $counter"
}
}
task0.dependsOn task2, task3
输出结果
六:短标记法
短标记 $ 可以访问一个存在的任务. 也就是说每个任务都可以作为构建脚本的属性。
task hello << {
println 'Hello world!'
}
hello.doLast {
println "Greetings from the $hello.name task."
}
输出结果:name 是任务的默认属性, 代表当前任务的名称, 这里是 hello.
七:自定义Task属性
给任务加入自定义的属性, 设置一个初始值给 ext.myProperty。
task myTask {
ext.myProperty = "myValue"
}
task printTaskProperties << {
println myTask.myProperty
}
输出结果
八:默认任务
等价于 gradle -q clean run. 在一个多项目构建中, 每一个子项目都可以有它特别的默认任务. 如果一个子项目没有特别的默认任务, 父项目的默认任务将会被执行.
defaultTasks 'clean', 'run'
task clean << {
println 'Default Cleaning!'
}
task run << {
println 'Default Running!'
}
task other << {
println "I'm not a default task!"
}
九:Task依赖
在Gradle中各个task并不是孤立的,它们可以是相互依赖的。
要让一个task依赖另外一个task,只需要在task定义时加入 dependsOn说明即可,被依赖的task会优先依赖者被执行。
例如task intro 依赖于task hello:
task hello << {
println 'Hello world!'
}
task intro(dependsOn: hello) << {
println "I'm Gradle"
}
输出结果
十:Gradle插件
Gradle的设计理念是,所有有用的特性都由Gradle插件提供;当使用Gradle插件时,它会将许多任务自动的加入到你项目里。Gradle本身提供了一系列的标准插件。如:
apply plugin: 'com.android.application'
;apply plugin: 'java'
这样就可以引入许多task,只需要使用相应的task命令就可以进行项目构建。例如下列一些task:
gradle build:编译整个项目,它会执行代码编译、代码检测和单元测试等
gradle assemble:编译并打包你的代码, 但是并不运行代码检测和单元测试
gradle clean:删除 build 生成的目录和所有生成的文件
gradle check:编译并测试你的代码。其它的插件会加入更多的检查步骤。
十一:外部依赖
在 Gradle 中, JAR 文件位于一个仓库中,这里的仓库类似于 maven 的仓库。
首先,指定maven的仓库地址:
repositories {
mavenCentral()
}
Android中是jcenter
repositories {
jcenter()
}
mavenCentral()是Gradle内置的一个maven仓库地址,加入maven仓库后,就可以直接加入maven仓库中的外部依赖,如果这个外部依赖不存在,gradle会联网去maven仓库中自动下载它,并将它缓存到本地,下次再使用时会优先从本地缓存中查找该依赖。
引用一个外部依赖需要指定使用的group, name 和 version 属性,三者缺一不可。
dependencies {
compile group: 'commons-collections', name: 'commons-collections', version: '3.2'
// 简化写法
// compile 'commons-collections:commons-collections:3.2'
}
十二:本地依赖
Gradle也可以从本地目录中引入JAR包依赖,可以单一引入指定的某一JAR包,也可以引入某目录下所有的JAR包
dependencies {
compile files('dir/file.jar')
compile fileTree(dir: 'libs', include: '*.jar')
}
十三:项目依赖
在Gradle中,使用文件settings.gradle定义当前项目的子项目。
include 'sub-project1', 'sub-project2', 'sub-project3'
sub-project1依赖sub-project2,则在sub-project1的build.gradle中加入以下配置即可:
dependencies {
compile project(':sub-project2')
}
十四:依赖关系管理和配置
Gradle允许对依赖进行相应的配置,通过不同的配置可以形成不同的依赖效果。
编译时不junit的jar包不会被引入,进行测试时junit的jar包才会被引入。
apply plugin: 'java'
repositories {
mavenCentral()
}
dependencies {
compile group: 'org.hibernate', name: 'hibernate-core', version: '3.6.7.Final'
testCompile group: 'junit', name: 'junit', version: '4.+'
}
规则
compile 用来编译项目源代码的依赖
runtime 在运行时被生成的类使用的依赖。 默认的, 也包含了compile时的依赖。
testCompile 编译测试代码的依赖。 默认的, 包含runtime时的依赖和compile时的依赖。
testRuntime 运行测试所需要的依赖。 默认的, 包含上面三个依赖。