Gradle学习3——自定义属性

学习本系列前可以下载相关的github项目gradleLearnDemo
地址:https://github.com/sososeen09/gradleLearnDemo

读取和设置Project和Task的属性是很重要的一块内容,每个Project和Task实例都提供了可以通过getter和setter方法访问的属性。一个属性可能是一个任务的描述或者项目的版本。你也可以定义自己的属性。Gradle允许用户通过扩展属性自定义一些变量。还有,很多Plugin都会加入扩展属性,可以通过设置属性来控制使用Pulgin。

1 Project自带的属性

Gradle在默认情况下已经为Project定义了很多属性,其中比较常用的有:
project:Project本身对象
name:Project的名字
path:Project的绝对路径
description:Project的描述信息
buildDir:Project构建结果存放目录
version:Project的版本号
属性都可以通过getter和setter方法来访问,也可以直接使用点好的形式来访问,例如:

setDescription('myProject')
println "Description of project $name: "+project.description

当在build.gradle中访问属性和方法的时候,不需要使用project变量,它会假设你使用的是project实例。但是有一些情况需要注意,例如:

version = 'this is the project version'
description = 'this is the project description'

task showProjectProperties << {
   println version
   println project.description
   println description
}

由于Task本身也有description属性,所以当在Task中,如果不显式的指定project,就会打印的是Task的description。这是因为定义Task的闭包将delegate设置成了当前的Task。有关delegate的介绍,我们可以看前一篇文章。
Gradle还为我们提供了多种方法来自定义Project的Property。

2 额外属性

Gradle的很多领域模型类提供了特别的属性支持。在内部,这些属性以简直对的形式存储。为了添加属性,你需要使用ext命名空间。

// 只在初始声明额外属性时需要使用ext命名空间
project.ext.myProp='myValue'

ext{
        someOtherProp=123
}

// 使用ext命名空间访问属性是可选的
assert myProp=='myValue'

println project.someOtherProp

ext.someOtherProp=567

类似的,额外的属性也可以通过属性文件来提供。

3 Gradle属性

Gradle属性可以通过在gradle.properties文件中声明直接添加到项目中,这个文件位于<USER_HOME>/.gradle目录或者项目的根目录下。这些属性可以通过项目实例访问。即使有多个项目,每个用户也只有能一个Gradle属性文件在xx/.gradle目录下,这是目前Gradle对它的限制。

在这个属性文件中声明的属性对所有的项目可用。
我们假设在gradle.properties文件中声明的:

exampleProp=myValue
someOtherProp=455

可以按照如下方式访问项目中的这两个变量

assert project.exampleProp=='myValue'

task printGradleProperties <<{
    println "Second property :$someOtherProp"
}

4 声明属性的其他方式

前面两种方式,我们大多用来声明自定义变量及其值。Gradle也提供了很多其他方式为构建提供属性。

4.1 项目属性通过 -P命令行选项提供

对于下面的例子,

task printMyProperties <<{
    println myProperties
}

如果我们直接执行 gradle -q printMyProperties 命令,会报错:

* What went wrong:
Execution failed for task ':printMyProperties'.
> Could not get unknown property 'myProperties' for task ':printMyProperties' of type org.gradle.api.DefaultTask.

这是因为myProperties属性没有定义,所以我们在调用gradle命令的时候可以通过 -P 命令来传参数,就可以把这个属性打印出来。

gradle -q -P myProperties='this is -P params'  printMyProperties

4.2 系统属性通过 -D命令行选项提供

与在Java中类似的,我们在Gradle中也可以通过-D来定义JVM的系统参数,只是需要增加一些约定,每个通过-D 方式声明的属性前面都要以“org.gradle.project”为前缀,例如:

gradle -q -D org.gradle.project.myProperties='this is -D params'  printMyProperties

4.3 环境属性模式提供

我们可以通过设置环境变量的形式来设置Project的属性。但是也要增加一些约定,例如每个属性前面都要加上一个ORG_GRADLE_PROJECT_的前缀,例如:

ORG_GRADLE_PROJECT_propertyName=someValue

当你再去执行printMyProperties这个task的时候就不用传参数了。

下一篇,我们会开始探索task的依赖,构建的生命周期等内容。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,670评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,928评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,926评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,238评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,112评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,138评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,545评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,232评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,496评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,596评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,369评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,226评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,600评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,906评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,185评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,516评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,721评论 2 335

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,497评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,071评论 25 707
  • 这篇文章讲给大家带来gradle打包系列中的高级用法-自己动手编写gradle插件。我们平常在做安卓开发时,都会在...
    呆萌狗和求疵喵阅读 15,960评论 22 80
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,679评论 6 342
  • 高景争来草木头 一生心事酒前休 山公自是仙人侣 携手醉登城上楼 一棵种子 从土里发了芽 不知经过了多少风雨 历经多...
    丶足迹阅读 226评论 0 0