第二篇:gradle脚本运行环境分析(gradle的语义模型)
引言:通过上一篇的论述,我们知道gradle脚本是如假包换的groovy代码,但是这个groovy代码是运行在他的上下文环境里面的,学名叫语义模型。这一篇我们就来看看他的语义模型到底是什么,如何使用。
gradle下载安装
gradle的下载安装并没有什么出乎意料的东西,进入他的官网(http://gradle.org/),下载gradle压缩包,解压,配置bin路径到Path即可。
我安装在c盘下,进入目录C:\gradle-2.4\docs\userguide,打开userguide.pdf文件,这个就是gradle的向导帮助文档。
gradle 语义模型
gradle使用project和task来实现构建的操作,project对应工程,task对应具体的任务,例如编译,压缩,生成帮助文档。我们从userguide.pdf的chap 6中截取一个hello world的Demo来说明,以便有个初步的印象。
创建一个空文件夹Demo,进入,再创建一个build.gradle文件,并写入如下的代码:
task hello {
println "hello world"
}
在命令行中输入 gradle -q hello (-q 参数用于删除冗余的输出),会得到hello world的输出。这一段脚本通过调用project类的task方法,添加了一个新的task在project的task map中,其中键是“hello”,后面跟着一个闭包,里面的代码用于配置这个task的一些属性,相当于初始化这个task,这在下面action的例子中表现最明显。需要注意的是这里的task是关键字,并不是调用某一个方法,在解析的过程中,gradle还需要根据这个关键字进行转化才能生成标准的groovy代码。
在gradle中,project和build.gradle文件是一一对应的,通过这个文件可以配置project的各种属性。project的初始化流程如下:
(1)首先创建一个Settings的实例。(对应 org.gradle.api.initialization 下的 Interface Settings )
(2)如果当前目录有settings.gradle,那么用这个文件来配置Settings实例。
(3)用Settings实例来创建Project的层次关系。
(4)最后,如果项目中存在build.gradle就通过它来执行每个Project。项目中,项目分别依次横向执行,以此子项目一定在父项目之后执行。这个规则可以通过调用evaluationdependsonchildren()或加入一个明确的依赖usingevaluationdependson(String)。
从初始化流程来看,项目之间的层次和依赖关系是通过settings.gradle来配置的,而project的具体任务执行是通过build.gradle来配置的。在build.gradle中可以添加系统提供的task和自定义的task,例如上例就是自定义的task。Project还可以通过添加插件来添加能支持的task。task是由action组成,action可以理解成真正的执行功能的代码块,可以调用doFirst,doLast,leftShift和<<添加action。我们举一个既有配置代码,又有action的例子,看下面的代码:
action的例子
task hello {
println "hello world"//初始化
}<<{
println "hello world action"
} task hello1 {
println "hello world1"//初始化
}<<{
println "hello world1 action"
}
我们用上一个例子中运行task的方法调用hello1,即输入:gradle hello1,输出为:
# gradle hello1
hello world
hello world1
:hello1
hello world1 action BUILD SUCCESSFUL Total time: 2.086 secs
可以看出初始化的代码是一定执行的,而Task hello的Action代码,要用gradle指定task才能执行。
从上面的两个例子,我们有了一个最初的印象,gradle构建从上到下的机构顺序应该是project---》task---》action。
每一个Project都通过一个TaskContainer来添加和管理他的task,这是一个task的容器,可以通过调用project的
getTasks()方法来获得,不过一般来说大家都通过task关键字来生成task,范例如下:
task myTask1 task myTask2 {
println "myTask2"
} task myType3 << {
println "myTask2 -- action"
}
task myTask4("dependsOn": myType3) task myTask5("dependsOn": myType3) {
println "myTask5 -- action"
}
当然可以直接用project里面的task()方法,使代码更加groovy一点:
task nTask1 task nTask2,{
println "nTask1"
} task nTask3,{
println "nTask3"
}<<{
println "nTask3 -- action"
} task nTask4,{
dependsOn(nTask3)
}
一旦task被创建,就可以用它的名字来引用它。
task nTask3,{
println "nTask3"
}<<{
println "nTask3 -- action"
} task nTask4,{
dependsOn(nTask3)
} nTask4 << {
println "nTask4 -- action"
}
# gradle nTask4
nTask3 -- action
nTask3
:nTask3 UP-TO-DATE
:nTask4
nTask4 -- action BUILD SUCCESSFUL Total time: 2.927 secs
应该是通过DSL转换来做的。
上面说Task中具体的执行步骤是通过Action来完成的,Action的结构十分简单,只有一个方法
void execute(T t) Action在Task中排列成一个队列,依次执行。增加Action有4个方法,上面已经提过,看下面的例子:
task nTask4 {
println "this is config"//配置这个task
}
nTask4 << {
println "nTask4 -- add action by <<" //通过 <<来增加action
}
nTask4.leftShift {
println "nTask4 -- add action by leftShift "//通过leftShift方法来增加action,等同 <<
}
nTask4.doFirst {
println "nTask4 -- doFirst" //在action队列的最前面插入一个Action
} nTask4.doLast {
println "nTask4 -- doLast" //在action队列的最最后插入一个Action
}
输出为:
# gradle nTask4
this is config
:nTask4
nTask4 -- doFirst
nTask4 -- add action by <<
nTask4 -- add action by leftShift
nTask4 -- doLast BUILD SUCCESSFUL Total time: 2.935 secs
结果一目了然,doFirst最先执行,<<和leftShift的调用时序决定先后顺序,而doLast在最后。能这样做的数据结构,当然是队列,事实也确实如此,在Task接口中,用的是List,而在抽象类AbstractTask中用ArrayList实现的。
Project和Task的属性设置和依赖关系可以参考这篇博客:http://www.blogjava.net/wldandan/archive/2012/07/05/382246.html。
增加一个例子作说明
//project 自带属性
println Project.DEFAULT_BUILD_DIR_NAME
println DEFAULT_BUILD_DIR_NAME //本地属性
String msg = "hello world" //extension 属性
ext{//用 ext 关键字
projectProperties = "ext projectProperties-value"
}
//直接调用方法
project.getExtensions().create("mMsg", Msg) task hello (){
println msg //初始化
}<<{
println "ext properties :"+projectProperties
projectProperties = "chang the extension propertise"
println "ext properties :"+projectProperties
// println project.property(projectProperties) //无法执行
println project.property("projectProperties")
println mMsg.des
} class Msg {
String des = "this is a msg"
int id = 10
}
输出为:
# gradle hello
build
build
hello world
:hello
ext properties :ext projectProperties-value
ext properties :chang the extension propertise
chang the extension propertise
this is a msg BUILD SUCCESSFUL Total time: 3.028 secs
通过上面的例子说明了动态增加属性的方式。由此可以见,一个Project增加属性和Task都是可行的。当某一类Task需要集体带入的话(比如整个android的编译过程),一个个通过task方法加入就过于麻烦了,解决方案也很简单,我把Project的实例给这一类Tasks的管理类(比如XXManager,在gradle中叫XXPlugin,或者直接叫 java,android),由这个管理类自己添加需要的task,举个例子:
apply plugin: DateAndTimePlugin dateAndTime {
timeFormat = 'HH:mm:ss.SSS'
dateFormat = 'MM/dd/yyyy'
} class DateAndTimePlugin implements Plugin<Project> {
void apply(Project project) {
project.extensions.create("dateAndTime", DateAndTimePluginExtension)
project.task('showTime') << {
println "Current time is " + new Date().format(project.dateAndTime.timeFormat)
}
project.tasks.create('showDate') << {
println "Current date is " + new Date().format(project.dateAndTime.dateFormat)
}
}
} class DateAndTimePluginExtension {
String timeFormat = "MM/dd/yyyyHH:mm:ss.SSS"
String dateFormat = "yyyy-MM-dd"
}
Task已经加入,我们直接使用就可以了,
# gradle showTime showDate
:showTime
Current time is 15:52:15.841
:showDate
Current date is 09/01/2015 BUILD SUCCESSFUL Total time: 2.132 secs
参考:
负责task转换的类:org.gradle.groovy.scripts.internal.TaskDefinitionScriptTransformer.java
http://www.gradle.org/docs/current/javadoc/org/gradle/api/Project.html
http://www.gradle.org/docs/current/javadoc/org/gradle/api/Task.html
第二篇:gradle脚本运行环境分析(gradle的语义模型)的更多相关文章
- gradle教程 [原创](eclipse/ADT下 非插件 非Android Studio/AS)纯手打 第二篇:gradle简单实战
一个bug 一个脚印的叫你们用gradle. 1介于网络上的很多资料都是老的 不适用与现在的新版本gradle 尤其是有些gradle方法改名了老的用不了 2介于网上都是粘贴复制并且零碎我很蛋疼啊,走 ...
- 【转载】Gradle for Android 第二篇( Build.gradle入门 )
理解Gradle脚本 当然我们现在讨论的所有内容都是基于Android studio的,所以请先行下载相关工具.当我们创建一个新的工程,Android studio会默认为我们创建三个gradle文件 ...
- 写完批处理脚本,再写个Gradle脚本,解放双手
前言 上一篇写个批处理来帮忙干活---遍历&字符串处理中,我们已经学习如何写批处理脚本来帮我们做一些简单的重复性工作,本篇继续来学习如何用 Gradle 写脚本,让它也来帮我们干活 Gradl ...
- Gradle 脚本剪片---copy
Gradle是以Groovy语言为基础,基于DSL语法的自动化构建工具,一个构建脚本能够包含任何Groovy语言元素,每个脚本都是UTF-8编码的文件. 6-1 Project对象API 前面我们说过 ...
- Android Gradle脚本从Groovy迁移到Kotlin DSL
Android Gradle从Groovy迁移到Kotlin Android项目用Gradle构建, 其脚本语言之前是Groovy, 目前也提供了Kotlin的支持, 所以可以迁移到Kotlin. 官 ...
- Gradle 1.12用户指南翻译——第二十二章. 标准的 Gradle 插件
其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Github上的地址: https://g ...
- 皮肤包项目的 Gradle 脚本演化
我在做的一个项目需要有换肤功能,换肤的方案是采用第三方库 ThemeSkinning 的实现(在其基础上修复若干 bug).皮肤的制作是把相关的资源放在一个 app module 中打包成 apk,当 ...
- 从编程的角度理解gradle脚本﹘﹘Android Studio脚本构建和编程[魅族Degao]
本篇文章由嵌入式企鹅圈原创团队.魅族资深project师degao撰写. 随着Android 开发环境从Eclipse转向Android Studio,我们每一个人都開始或多或少要接触gradle脚本 ...
- 转载 LibGDX: 使用 Gradle 命令运行和打包项目
版权声明:本文为csdn xietansheng 博主原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明. 本文链接: http://blog.csdn.net/xieta ...
随机推荐
- selenium2.0 处理各种窗口问题解决方法
selenium2.0处理muti-Windows . Frames .Popup Dialogs selenium2.0处理多窗口,弹窗等,只需要调用WebDriver 嵌套类:TargetLoca ...
- Curl之获取外网IP
获取外网IP:curl -s ifconfig.me
- 自定义控制器的View(loadView)及其注意点
*:first-child { margin-top: 0 !important; } body > *:last-child { margin-bottom: 0 !important; } ...
- image sensor 积分时间
integration time 积分时间 当光源周期与integration time成整数倍时才不会产生flicker integration time即积分时间是以行为单位表示曝光时间(exp ...
- delphi 提取字符中的数字
Function Setstring(cString:string):string; {提取数字} VAr i:integer; str:string; begin str:='' ...
- HW4.5
public class Solution { public static void main(String[] args) { final double POUNDS_PER_KILOGRAM = ...
- HW3.28
import java.util.Scanner; public class Solution { public static void main(String[] args) { Scanner i ...
- HW3.6
import java.util.Scanner; public class Solution { public static void main(String[] args) { Scanner i ...
- hdoj 1898 Sempr == The Best Problem Solver?
Sempr == The Best Problem Solver? Time Limit: 2000/1000 MS (Java/Others) Memory Limit: 65535/3276 ...
- 在 windows 上面安装 tensorflow
这个是 tensorflow 官网地址, https://www.tensorflow.org/get_started/os_setup#pip_installation_on_windows 上面有 ...