Java管理——Gradle使用速记

全文共 1096 个字

安装

安装SDKMAN

Gradle在安装之前可以选择很多安装方式,这里选择SDKMAN。其他方式见安装说明

linux安装SDKMAN,分别执行:

# 下载安装执行
$ curl -s "https://get.sdkman.io" | bash
# 自行设置
$ source "$HOME/.sdkman/bin/sdkman-init.sh"

安装结果测试。

输入:

$ sdk version 

成功安装会输出:

==== BROADCAST =================================================================
* 02/07/18: Kscript 2.4.5 released on SDKMAN! #kscript
* 28/06/18: Micronaut 1.0.0.M2 released on SDKMAN! #micronautfw
* 27/06/18: Infrastructor 0.2.0 rolling out. With stronger encryption and new task progress UI.
================================================================================

SDKMAN 5.6.4+305

安装Gradle

Gradle需要JDK7以上才能运行,请先使用 java -version 命令确定环境。 

使用SDKMAN安装Gradle:

# 4.8.1是当前gradle的版本,根据需要调整
$ sdk install gradle 4.8.1

安装完成后输入gradle -v检查安装结果:

$ gradle -v
------------------------------------------------------------
Gradle 4.8.1
------------------------------------------------------------

Gradle基础要点知识

  • 一个Gradle文件(例如build.gradle)视为一个project。在Gradle的项目组织中就2个层级——Project和Task。
  • 在Gradle中有3个重要的概念Project、Plug、Task。三者的关系:Project就是一个容器,里面可以放置各种类型的Task,Plug是一堆Task的集合。
  • Gradle中所有的功能都是以一个Task实现的,包括Jar包的依赖。
  • Properties:Project和Task都有自己的属性(Properties)。Project级别的属性可以设置,也可以通过外部传入。

一个配置案例

/**
build.gradle
这是一个使用 gradle init --type java-application创建的Gradle Project,进行了一些修改
整个文件的范围都是一个Project。
**/
// ---------------------------------------------------------------------
// 引入预设的Plug
// 一个plug中会包含多个Task
// plugins是Project的一个方法
// 里面的id实际上也是一个方法。
plugins {
    id 'java'
    id 'application'
}

// 资源路径的设置参数。用于java plug中的task
// Gradle的资源路径和Maven的几乎一样,也可以单独配置
sourceSets {
   main {
      java {
         srcDir 'src/main/java'
      }
      resources {
         srcDir 'src/main/resources'
      }
   }
}
//-----------------------------------
/**
如果不设置,资源路径默认为:
src {
   main{
      java
      res
   }
   test{
      java
      res
   }
}
**/
//-----------------------------------

// mainClassName可以理解为一个变量
// 定义这个程序的Main Class,实际上这也是在设定一个Project的属性
mainClassName = 'App'

//预设一个用于装载结构的类,Gradle使用groovy语法
class GroupAndVersion {
	String group
	String version
}

// 向project添加一个名为“spring”的属性,属性的值是一个GroupAndVersion的一个实例。
// ext是Project的一个方法,作用就是添加一个属性。
ext {
	spring = new GroupAndVersion(group:'org.springframework', version:'5.0.7.RELEASE')
}

// dependencies 是由某个plug中的预设的“方法”,
// Gradle是groovy语法,这里就是执行Project.dependencies方法
// Plug中可以用project.extensions.create扩展Project中的定义方法
dependencies {
    //compile表示引入包的执行域
    compile 'com.google.guava:guava:23.0'

    //使用定义好的属性引入包
	compile group: spring.group, name: 'spring-core', version: spring.version
	compile group: spring.group, name: 'spring-beans', version: spring.version
	compile group: spring.group, name: 'spring-context', version: spring.version

    testCompile 'junit:junit:4.12'
}

// repositories与dependencies一样的性质,同样会被用于某个task
// repositories用于指定依赖仓库
repositories {
    jcenter()
}

// 自定义的一个任务,用于呈现当前依赖包的物理地址
task show << {
	println configurations.compile.asPath
}

配置文件对应的工程结构:

project
--bin IDE动态编译的文件(Eclipse)
----main
----test
--build 运行gradle build命令生成的文件
---- classes Java 工程目录对应的.class文件
---- distributions 打包之后的压缩包
---- lib 打包之后的jar
---- report 测试报告
---- scripts 打包之后的启动脚本
---- test-result 测试结果
---- tmp 临时文件,比如会在打包jar之前临时存放MANIFEST.MF
--gradle gradle执行相关的文件,比如gradle-wrapper
--src 源码和资源
----main
----text
--build.gradle
--gradlew
--settings.gradle

设置仓库源

默认情况下Gradle会使用Maven或Ivy的中央仓库,在当前用户的${home}.gradle文件下新建一个init.gradle文件,然后写入:

allprojects{
  repositories {
    def REPOSITORY_URL = 'http://maven.aliyun.com/nexus/content/groups/public/'
      all { ArtifactRepository repo ->
        if(repo instanceof MavenArtifactRepository){
          def url = repo.url.toString()
          if (url.startsWith('https://repo1.maven.org/maven2') || url.startsWith('https://jcenter.bintray.com/')) {
            project.logger.lifecycle "Repository ${repo.url} replaced by $REPOSITORY_URL."
            remove repo
          }
       }
    }
    maven {
      url REPOSITORY_URL
    }
  }
}

这样链接的仓库会执行国内的阿里镜像。

快速初始化项目

Gradle提供了初始化各自类型项目的命令:

$ gradle init --type <name>
# <name>取以下值
# java-application java应用程序
# java-library jar包
# scala-library scala包
# groovy-library groovy包
# basic 基本工程
# 配置出来的工程结构都可以在后期通过修改build.gradle修改