gradle基础配置
gradle常用命令
//列出项目的所有属性. 这样你就可以看到插件加入的属性以及它们的默认值.
gradle properties
//列出项目的所有任务
gradle -q tasks --all
字符串
-
' ' 仅仅表示一个字符串
-
" " 字符串拼接,可以拼接变量变量,也可以拼接任务$任务
-
''' ''' 可以用来换行
定义常量
一个项目对应一个project实例,gradle根据build.gradle配置内容实例化project实例
project属性有group,name,version
方法有apply ,repositories,dependencies,task
属性的其他配置方式可以通过 : ext , gradle.properties
ext.property1 = "this is property1"
//也可以用闭包的方式
ext {
property2 = "this is property2"
}
定义任务
task hello {
doLast {
println 'Hello world!'
}
}
快捷的定义方式,使用<< 代替 doLast{}
<< 操作符是 doLast 的简单别称.
task helloWorld << {
println 'helloWorld343'
}
默认任务定义,调用任何任务都会执行的任务,没有<< 也米有doLast{}
task defaultmytask {
println 'ddddddd'
}
声明任务之间的依赖
intro 依赖于 hello, 所以执行 intro 的时候 hello 命令会被优先执行来作为启动 intro 任务的条件.
在加入一个依赖之前, 这个依赖的任务不需要提前定义
task hello << {
println 'Hello world!'
}
task intro(dependsOn: hello) << {
println "I'm Gradle"
}
动态任务
下面的times是遍历,counter是遍历的变量名
4.times { counter ->
task "task$counter" << {
println "I'm task number $counter"
}
}
使用插件
//方式一
plugins {
id 'war'
id 'org.hidetake.ssh' version '2.9.0'
}
//方式二
//插件
apply plugin: 'java-library'
apply plugin: 'eclipse'
apply plugin: 'maven'
apply plugin: 'java'
使用仓库
repositories
{
//第三方仓库
maven{url 'http://maven.aliyun.com/nexus/content/groups/public/'}
//maven中央仓库
mavenCentral()
jcenter()
}
添加依赖
dependencies {
compile group: 'commons-collections', name: 'commons-collections', version: '3.2'
testCompile group: 'junit', name: 'junit', version: '4.+'
}
定制项目
//jdk版本
sourceCompatibility = 1.8
//编码
[compileJava,compileTestJava,javadoc]*.options*.encoding = 'UTF-8'
//项目版本
version = '1.0'
上传jar包
uploadArchives {
repositories {
flatDir {
dirs 'repos'
}
}
}
uploadArchives {
repositories {
mavenDeployer {
//userName 和 password 为maven的用户名和密码
repository(url: "http://172.30.10.160:8081/nexus/content/repositories/snapshots/") {
authentication(userName: "deploy", password: "deploy123")
}
pom.project {
name=project.name
packaging='jar'
description='a test'
}
}
}
}
也可以使用maven-publish插件
多项目构建
//settings.gradle
//上下层级构建多项目
rootProject.name = '111'
include '111-1'
include '111-2'
//同一层级构建多项目
rootProject.name = '111'
includeFlat '111-1'
includeFlat '111-2'
项目之间的依赖
dependencies {
compile project(":111-2")
}
解决版本冲突
-
查看依赖报告
-
排除传递性依赖
-
强制指定一个版本
groovy默认使用最高版本帮助我们解决版本冲突
//修改默认策略,如果由版本冲突,就构建失败
configurations.all {
resolutionStrategy {
failOnVersionConflict()
}
}
//解决方式
//1.排除传递性依赖
dependencies {
compile (''){
exclude
}
}
//2.强制指定一个版本
configurations.all {
resolutionStrategy {
failOnVersionConflict()
force ''
}
}
多项目构建-公共配置
allprojects对所有的项目有效
subprojects对所有的项目有效也可以个性化定制
allprojects {
apply plugin: 'java'
sourceCompatibility = 1.8
//修改默认策略,如果由版本冲突,就构建失败
configurations.all {
resolutionStrategy {
failOnVersionConflict()
}
}
uploadArchives {
repositories {
flatDir {
dirs 'repos'
}
}
}
}
//仓库,依赖放在allprojects中也可以
subprojects {
//仓库
repositories {
jcenter()
}
//依赖
dependencies {
}
}
属性也可以定义在gradle.properties
group=com.home.woms version=1.1.1
多项目构建-独享配置
在父项目bulid.gradle中配置子项目
project(‘:core’) {
ext{
hibernateVersion = ‘4.2.1.Final’
}
dependencies {
compile “org.hibernate:hibernate-core:${hibernateVersion}”
}
}
多项目构建-多环境配置
http://www.infoq.com/cn/articles/Gradle-application-in-large-Java-projects/
1. 通过指定不同的资源文件目录
-
resources: 通用配置放在这儿
-
resources-dev: 开发环境配置
-
resources-prod: 生产环境配置
apply plugin: 'war'
archivesBaseName = 'project-web'
version = '1.0.0'
//
// 设置默认 resources 为开发环境状态
//
// 这儿如果不设置的话,idea 编译时只会默认获取 resources 目录
//
sourceSets {
main {
resources {
srcDirs = ['src/main/resources', 'src/main/resources-dev']
}
}
}
task release (dependsOn : war) {
doFirst{
sourceSets {
main {
resources {
srcDirs = ["src/main/resources", "src/main/resources-prod"]
}
}
}
}
doLast{
println "${sourceSets.main.resources.srcDirs}"
}
}
-
gradle war: 这个是用来打测试的 war 包,采用的是 resources-dev。
-
gradle release: 这个才是用来打生产用的 war 包,采用的是 resources-prod。
ext {
profile = project['profile']
}
sourceSets {
main {
resources {
srcDir "config/application/spring/${profile}",
"config/application/properties/${profile}"
}
}
}
//这样在打包的过程中,就可以使用-P传入的参数的资源文件夹下面的properties和xml文件作为项目的配置文件。
2. 传统的properties文件
//第一种方式是使用传统的properties文件, 然后在使用Gradle时,通过传入不同的参数加载不同的properties文件。例如,我们可以在项目中提供development.properties、test.properties和production.properties。在项目运行时,使用-Pprofile=development来指定加载开发环境的配置。构建脚本中加载properties文件的代码如下
allprojects{
apply plugin: 'java'
ext {
profile = 'uat'
// profile = project['profile']
}
//gradle构建过程中的默认任务processResources,重写
processResources {//替换文件使用@key@来标注要被替换的位置,例如 username=@username@
from(sourceSets.main.resources.srcDirs) {
filter(org.apache.tools.ant.filters.ReplaceTokens,tokens: loadProperties())
}
}
}
def loadProperties(){
def props = new Properties()
new File("${rootProject.projectDir}/conf/${profile}.properties")
.withInputStream {
stream -> props.load(stream)
}
props
}
3. config.groovy配置文件
def loadGroovy(){
def configFile = file('config.groovy')
new ConfigSlurper(profile).parse(configFile.toURL()).toProperties()
}
//替换
processResources {
from(sourceSets.main.resources.srcDirs) {
filter(org.apache.tools.ant.filters.ReplaceTokens,tokens: loadGroovy())
}
}
构建脚本的依赖
除了项目需要依赖之外,构建脚本本身也可以有自己的依赖。当使用一个非Gradle官方提供的插件时,就需要在构建脚本里指定其依赖,当然还需要指定该插件的Repository。在Gradle中,使用buildscript块为构建脚本配置依赖。
比如在项目中使用cucumber-JVM作为项目BDD工具,而Gradle官方没有提供它的插件,好在开源社区有人提供cucumber的插件。在构建脚本中添加如下代码:
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath "gradle-cucumber-plugin:gradle-cucumber-plugin:0.2"
}
}
apply plugin: com.excella.gradle.cucumber.CucumberPlugin
apply其他Gradle文件
当一个项目很复杂的时候,Gradle脚本也会很复杂,除了将子项目的配置移到对应项目的构建脚本之外,还可以可以按照不同的功能将复杂的构建脚本拆分成小的构建脚本,然后在build.gradle里使用apply from,将这些小的构建脚本引入到整体的构建脚本中去。比如在一个项目中既使用了Jetty,又使用了Cargo插件启动JBoss,就可以把他们分别提到jetty.gradle和jboss.gradle,然后在build.gradle里使用如下的代码将他们引入进来:
apply from: "jetty.gradle"
apply from: "jboss.gradle"
定义资源目录
sourceSets {
main {
java {
srcDir 'src/main/java' // 指定源码目录
}
resources {
srcDir 'src/main/resources' //资源目录
}
}
}
//或者
sourceSets {
main.java.srcDirs = ['src/main/java']
main.resources.srcDirs = ['src/main/resources']
}