Gradle 入门

时间 2019-11-09

标签 gradle 入门栏目 Gradle 繁體版

原文原文链接

目录 starthtml

目录 end |2018-08-03| 码云 | CSDN | OSChina
****************************************java

Gradle

官方 guide | 其余 tutorial
参考博客: 零散知识点总结(1) - Gradle 使用配置总结git

我的见解github

参考: Gradle在大型Java项目上的应用web

优缺点spring

Gradle大吐槽
 官方对比Gradle和Mavenmongodb

优势docker

相对于Maven, 配置文件简洁了不少, 因此才入坑学习使用的
对于一些须要自定义的任务,由于核心为Groovy,因此实现能力高
- 例如:将一个SpringBoot项目构建成一个镜像,并tag上当前构建的镜像为release,而后删除旧有容器,使用新的镜像启动容器

缺点windows

内存占用巨大,存在内存泄露问题, 以致于在IDEA上不敢使用自动导入, 否则每动一下build.gradle 就会卡半天, 8G内存都不够用!!
编译速度慢, 若是和Maven进行对比, 编译速度和资源占用确实慢

书籍

Gradle in Action 中译 若是没有一点Groovy基础, 阅读自定义Task等一些高自定义的地方仍是比较困惑后端

发行版本列表

官方网址有各个版本的下载以及版本发行说明
彷佛版本越高，内存占用越大，从4.7降级回了4.2

4.6

发行说明 | 支持Junit5, 还有解决依赖冲突的一种声明式方式

安装配置

和maven使用同一个本地库只要加上 M2_HOME 环境变量便可, 值和 MAVEN_HOME 同样, 并无用

SDKMAN方式

先安装sdkman
使用Bash运行curl -s "https://get.sdkman.io" | bash
sdk install gradle 便可安装

Chocolate

windows 上安装 chocolate
PowerShell中运行 wr https://chocolatey.org/install.ps1 -UseBasicParsing | iex
若操做系统默认禁止执行脚本，执行一次set-executionpolicy remotesigned后脚本顺利执行
Chocolatey在安装包的时候，默认路径是按照系统的默认路径来的，若是想修改安装路径能够这样处理：

执行“开始/运行”命令（或者WIN + R），输入“regedit”，打开注册表。
展开注册表到下面的分支[HKEY＿LOCAL＿MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion]，在右侧窗口中找到名为“ProgramFilesDir”的字符串，双击把数值“C:\Program Files”修改成“D：\ProgramFiles”，肯定退出后,便可更改经常使用软件的安装路径了。

命令行选项

gradle 构建文件中的task名：直接运行task
-b，--build-file test.gradle 指定运行脚本文件
--offline 离线模式
-P ,--project-prop:配置参数 -Pmyprop=value
-i,--info : 打印info级别的输出
-s,--stacktrace: 输出错误栈
-q,--quiet:减小构建出错时打印的错误信息
tasks : 输出全部创建的task
properties : 输出全部可用的配置属性

守护进程

命令加上 --daemon就会开启一个守护进程，只会开启一次，
守护进程会在空闲3小时后销毁
手动关闭 gadle --stop
构建时不采用守护进程 --no--daemon

Docker安装

Docker 文档

配置镜像源

阿里云

参考博客: 配置Gradle的镜像为阿里云镜像

当前项目的build.gradle

repositories {
    def aliyun = "http://maven.aliyun.com/nexus/content/groups/public/"
    def abroad = "http://central.maven.org/maven2/"
    maven {
      url = aliyun
      artifactUrls abroad
    }
    // 马云上本身的库
    maven {
      url = "https://gitee.com/gin9/MavenRepos/raw/master"
    }
    mavenCentral()
    jcenter()
  }

全局的配置
~/.gradle/init.gradle

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

关键配置文件

build.gradle

Hello World

task helloworld{
      doLast {
         printf 'Hello World!'
      }
   }
   // 或者是 使用 << 表明doLast：
   task helloworld<<{
      println 'Hello world!'
   }

运行：gradle -q helloworld

初始化一个新项目

doc:building java application

dependency

和Maven用的是同一种方式 groupId artifactId version
使用本地依赖 compile files('lib/ojdbc-14.jar') 相对的根目录是src同级目录
可是依赖的类别要多于Maven
- compile
- testCompile
- runtime
- provide

统一依赖管理

新建一个文件 dependency.gradle

ext {
        ver = [
            junit     : '4.12',
        ]
        libs = [
            "junit"   : "junit:junit:$ver.junit",
        ]
    }

在 build.gradle 中引入 apply from: 'dependency.gradle'
使用依赖时只需 compile libs['junit']即便在子模块中也是如此使用

配置Wrapper

在使用IDE生成项目的时候，能够选择gradle的执行目录，能够选gradle wrapper 也能够选本身下载解压的完整包
若是使用的不是这个wrapper，那么别人在下载项目后，运行gradle命令就要先安装gradle，使用wrapper更好

task wrapper(type: Wrapper){
      gradleVersion = '4.8'
      distributionUrl = '限定访问内网的URL'
      distributionPath = '包装器被解压缩放的相对路径'
   }

运行 gradle wrapper 一次便可开始使用包装器的脚原本构建项目了
生成gradle包管理器：gradle wrapper --gradle-version 2.0

插件

有多种方式:

// 1
apply plugin: 'java'
// 2
apply{
    'java'
}
// 3
plugins{
    id 'java'
}

经常使用插件

lombok

使用Lombok的正确方式 | gradle lombok plugin

官方文档

annotationProcessor 'org.projectlombok:lombok:1.18.2'
  compileOnly 'org.projectlombok:lombok:1.18.2'
  testAnnotationProcessor 'org.projectlombok:lombok:1.18.2'
  testCompileOnly 'org.projectlombok:lombok:1.18.2'

maven
- apply plugin: "maven" 而后就能执行 install等命令了
- gradle 4.8 用不了须要这种方式
shadowJar 含依赖的jar进行打包
docker 提供Docker操做
- apply plugin: 'docker'
- buildscript dependencies 中添加classpath('se.transmode.gradle:gradle-docker:1.2')

setting.gradle

项目的配置信息, 通常存在这个文件的时候, Gradle就会认为当前目录是做为一个完整的根项目的, 并在当前目录添加 .gradle 目录
通常默认内容为 rootProject.name = ''

Gradle多模块的构建

官网文档 creating multi project builds

采用一个文件统一管理依赖, 而后各个子项目独立引用 | 完整示例 JavaBase统一配置依赖, 管理多模块

若是要添加一个项目也简单

直接新建一个目录 test
目录下新建空的文件 build.gradle
在根项目的 setting.gradle 中的include 加入 test (能够和文件夹不一样名, build.gradle配置下就好了, 建议同名)
gradle build 整个项目, 就完成了
最后就是手动的新建项目结构

另外一种方式

参考博客:重拾后端之Spring Boot（六） -- 热加载、容器和多项目
直接在build.gradle中配置

// 一个典型的根项目的构建文件结构
    buildscript {
        //  构建脚本段落能够配置整个项目须要的插件，构建过程当中的依赖以及依赖类库的版本号等
    }
    allprojects {
        //  在这个段落中你能够声明对于全部项目（含根项目）都适用的配置，好比依赖性的仓储等
    }
    subprojects {
        //  * 在这个段落中你能够声明适用于各子项目的配置（不包括根项目哦）
        version = "0.0.1"
    }
    //  * 对于子项目的特殊配置
    project(':common') {
    }
    project(':api') {
    }
    project(':report') {
    }

project(':common') {
        dependencies {
            compile("org.springframework.boot:spring-boot-starter-data-rest")
            compile("org.springframework.boot:spring-boot-starter-data-mongodb")
            compile("org.projectlombok:lombok:${lombokVersion}")
        }
    }

    project(':api') {
        dependencies {
            compile project(':common')
            compile("org.springframework.boot:spring-boot-devtools")
        }
    }

    project(':report') {
        dependencies {
            compile project(':common')
            compile("org.springframework.boot:spring-boot-devtools")
            compile files(["lib/simsun.jar"])
            compile("org.springframework.boot:spring-boot-starter-web")
        }
    }

部署

War包

Jar包

Gradle默认是只会打包源码，并不会打包依赖（为了更方便依赖的做用）
- shadow插件官网文档
添加 apply plugin: "maven" 而后就能和mvn install 同样的执行 gradle install 了

上传至构建仓库

特别注意使用gpg, 若是按这下面的一堆文档跟着作的话你要保证你的gpg小于等于2.0版本, 否则就卡在这里了

参考项目
 参考
 官方文档
 参考博客
 最简单的方式就是利用码云等平台建立私服

构建Docker镜像

用 Docker、Gradle 来构建、运行、发布一个 Spring Boot 应用

build.gradle

apply plugin: 'docker'
    buildscript {
        ext {
            springBootVersion = '2.0.1.RELEASE'
        }
        repositories {
            mavenCentral()
        }
        dependencies {
            classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
            classpath('se.transmode.gradle:gradle-docker:1.2')
        }
    }
    task buildDocker(type: Docker, dependsOn: build) {
        //设置自动上传的话，命名就不能乱取了，仓库名/镜像名：tag
    //    push = true
        test.enabled=false
        applicationName = jar.baseName
        dockerfile = file('src/main/docker/Dockerfile')
        doFirst {
            copy {
                from war
                into stageDir
            }
        }
    }

Dockerfile

FROM frolvlad/alpine-oraclejdk8:slim
    VOLUME /tmp
    # 配置通配符是为了避免受版本影响
    ADD weixin*.war app.war
    # ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.war"]
    ENTRYPOINT ["java","-jar","/app.war"]

gradle buildDocker 便可构建镜像
运行 docker run --name web --link postgre:db -p 5678:8889 -it 镜像 注意其中要关联PostgreSQL的容器

第二种插件方式

参考经过Gradle使用Docker部署 Spring Boot项目

1. gradle入门
2. Gradle 入门
3. Gradle入门
4. gradle入门使用
5. gradle入门学习
6. Gradle入门：简介
7. Gradle入门系列(四)——初识Gradle Task
8. Gradle 入门：（二）idea 建立gradle项目
9. Android Gradle（二）Gradle入门前奏
10. Gradle入门（二）IDEA创建Gradle工程
更多相关文章...
• Memcached入门教程 - NoSQL教程
• Neo4j数据库入门教程 - NoSQL教程
• YAML 入门教程
• Java Agent入门实战（一）-Instrumentation介绍与使用