gradle的使用 —— IDEA

安装与配置：下载安装包并解压

用户手册：https://docs.gradle.org/current/userguide/userguide.html
java可以直接到：https://guides.gradle.org/building-java-libraries/

安装包有两种类型（都是zip格式）： binary-only或 complete，complete中包含api和example等。具体可看 发行版本列表。安装包解压后，就可以直接用了。

windows系统可以把 …gradle/bin 路径配置到环境变量Path上。这样，windows可以使用cmd工具直接使用gradle命令，利用命令：gradle -v 查看gradle的版本信息。

常用gradle 任务

一般使用 “gradle [taskName] [options]” 的命令形式，执行任务
但是，若存在自定义脚本程序：gradlew，则应该使用 “.\gradlew [taskName]” 替换 “gradle [taskName]”

1、tasks：查看可执行命令的列表

由于Gradle构建使用了Application插件，因此您可以从命令行运行该应用程序。 首先，使用tasks任务查看插件添加了哪些任务。

2、wrapper：为项目生成Gradle wrapper

导入gradle项目后，应该先执行 gradle wrapper 命令。

避免下载不同版本的gradle。若导入的项目自带 gradle wrapper，且wrapper中使用的gradle版本在本地中不存在，则IDE会自动下载相应gradle版本。因为gradle 的各种版本都适用。

扩展参数：

 --gradle-version [versionNumber] ： 声明wrapper 的gradle版本
 
 

3、init：新建gradle 项目

利用 init 命令，选择 java application，新建gradle 项目

经过上述操作后，自动生成如下内容

├── build.gradle
├── gradle    
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── settings.gradle
└── src
    ├── main
    │   ├── java  
    │   │   └── demo
    │   │       └── App.java
    │   └── resources
    └── test      
        ├── java
        │   └── demo
        │       └── AppTest.java
        └── resources

4、build：编译项目，执行测试程序，生成测试报表

使用build 命令会自动执行一系列任务;

首次执行build时可能会比较慢，因为需要下载Guava、Junit 库;

对测试程序生成的 测试报表为html格式，存储地址为： [projectRootPath]/build/reports/tests/test/packages/index.html

4.1、build 参数

生成 build scan

不支持“gradle build --scan”.

.\gradlew build --scan

点击生成的项目build scan 路径地址，即可在网页上查看本项目的信息。

5、run：执行声明在mainClassName 中的main方法

一般为项目启动的入口方法

、dependencies：下载依赖

下载依赖到本地

gradle项目

结构

build/libs 下存储项目的可执行jar 包

需要包含的两个文件（使用 Groovy DSL）

1、settings.gradle

只包含一项配置：声明项目名称

rootProject.name = 'auth0-servlet'

2、build.gradle

• 声明依赖的下载仓库

repositories {
    mavenCentral()
}

• 声明项目依赖包
  • implementation group
  • testImplementation group

dependencies {
    implementation group: 'commons-collections', name: 'commons-collections', version: '3.2.2'
    testImplementation group: 'junit', name: 'junit', version: '4.+'
}

• 声明项目编译时的编码类型
  可解决 build 时出现的问题：编码GBK的不可映射字符

tasks.withType(JavaCompile) {
    options.encoding = "UTF-8"
}

扩展
1、[springboot的gradle使用]:
https://guides.gradle.org/building-spring-boot-2-projects-with-gradle/
https://docs.spring.io/spring-boot/docs/2.0.3.RELEASE/gradle-plugin/reference/html/