gradle构建脚本基础

gradle常用命令

//列出项目的所有属性. 这样你就可以看到插件加入的属性以及它们的默认值.
gradle properties
​
//列出项目的所有任务
gradle -q tasks --all
​

 

 


 

 

字符串

  1. ‘ ‘ 仅仅表示一个字符串

  2. ” ” 字符串拼接,可以拼接变量变量,也可以拼接任务​$任务

  3. ”’ ”’ 可以用来换行


定义常量

一个项目对应一个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") 
   
}

 


解决版本冲突

  1. 查看依赖报告

  2. 排除传递性依赖

  3. 强制指定一个版本

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. 通过指定不同的资源文件目录

https://github.com/someok/gradle-multi-project-example

  • 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']
}