Gradle概述、语法说明

Gradle是一种开源的自动化构建工具，它使用Groovy编程语言和Kotlin编程语言来编写构建脚本。Gradle结合了Apache Maven的依赖管理和Apache Ant的灵活性和控制。它是Android的官方构建工具，并且被许多Java项目用于构建、测试、发布和其他任务。

Gradle的核心概念

Projects 和 Tasks

在Gradle中，所有的构建都是由一个或多个projects组成的，每个project都是由一个或多个tasks组成的。一个task代表一个构建任务，比如编译源代码、打包jar文件、生成javadoc等。

Build Scripts

Gradle构建脚本是用Groovy或Kotlin编写的，通常命名为build.gradle（Groovy）或build.gradle.kts（Kotlin）。这些脚本定义了项目的构建配置，包括项目的依赖、版本、任务等。

Dependencies

Gradle通过配置依赖项来自动下载和缓存所需的库。它支持多种依赖仓库，包括Maven Central、JCenter和私有仓库。

Plugins

Gradle插件可以扩展Gradle的功能，提供预定义的任务和配置。例如，Spring Boot插件提供了构建Spring Boot应用程序的任务。

Configuration Files

除了构建脚本，Gradle还使用其他配置文件，如settings.gradle（或settings.gradle.kts），用于定义项目中包含的模块。

Gradle Wrapper

Gradle Wrapper允许在没有安装Gradle的情况下运行Gradle构建。它是一个脚本和库，随项目一起分发，确保了构建的一致性。

Gradle的生命周期

Gradle构建的生命周期分为三个阶段：

初始化阶段：Gradle确定哪些项目将参与构建，并为每个项目创建一个Project实例。
配置阶段：Gradle配置项目，执行构建脚本中的代码，构建项目的依赖关系图，并准备执行任务。
执行阶段：Gradle执行指定的任务和其他依赖任务。

Gradle的命令行界面

Gradle提供了丰富的命令行界面，可以使用命令行来执行任务、查看项目信息和诊断问题。常见的Gradle命令包括：

gradle build：构建项目。
gradle clean：清理项目构建的输出。
gradle tasks：列出项目中可用的任务。
gradle help --task <task>：查看特定任务的详细信息。

Gradle vs. Maven

Gradle和Maven都是用于Java项目的构建工具，但它们有一些关键的区别：

灵活性：Gradle提供了更多的灵活性和控制，因为它是基于Groovy和Kotlin的，而Maven则使用XML配置。
性能：Gradle通过增量构建和缓存机制提供了更快的构建速度。
依赖管理：两者都支持依赖管理，但Gradle提供了更丰富的依赖配置选项。

Gradle优缺点

Gradle的优点包括：

高度灵活：Gradle提供了高度灵活的构建脚本，可以轻松地自定义构建过程。
强大的依赖管理：Gradle具有强大的依赖管理功能，可以自动解决依赖关系，并下载所需的库。
快速的构建速度：Gradle通过增量构建和缓存机制，可以显著提高构建速度。
易于扩展：Gradle可以通过插件进行扩展，支持多种语言和框架。
社区支持：Gradle有一个庞大的社区，提供了大量的文档和插件。
Gradle的缺点包括：
学习曲线较陡峭：对于初学者来说，Gradle的学习曲线较陡峭，需要花费一定的时间和精力来掌握。
配置复杂：Gradle的配置相对复杂，需要编写大量的Groovy或Kotlin代码。
兼容性问题：由于Gradle的版本更新频繁，可能会出现兼容性问题。
与Java相比，Gradle是一种构建工具，而Java是一种编程语言。Gradle主要用于自动化构建和依赖管理，而Java主要用于开发各种应用程序。Gradle可以用于构建Java项目，也可以用于构建其他语言的项目，如Android、Groovy、Scala等。Java则是一种通用的编程语言，可以用于开发各种类型的应用程序，如Web应用程序、桌面应用程序、移动应用程序等。

Java中gradle配置文件说明

在Java项目中使用Gradle时，通常会涉及到几个关键的Gradle文件。这些文件定义了项目的构建配置和生命周期。下面是这些文件的说明：

build.gradle 或 build.gradle.kts:
- 这是项目的核心构建脚本，用于配置项目的依赖、版本、任务等。
- 使用Groovy或Kotlin编写，取决于项目采用的是哪种语言。
- 定义了项目的依赖项、插件、版本、任务和自定义配置。
settings.gradle 或 settings.gradle.kts:
- 这是项目全局设置文件，通常位于项目的根目录中。
- 用于定义项目中包含的模块（子项目）。
- 可以包含一些全局配置，例如项目名称和插件管理。
gradle.properties:
- 这是一个属性文件，用于定义Gradle构建时的全局属性。
- 可以用来设置项目范围的属性，如项目版本、构建使用的JVM参数等。
gradle-wrapper.properties:
- 这是Gradle Wrapper的配置文件，位于gradle/wrapper目录下。
- 定义了Gradle Wrapper使用的Gradle版本和下载位置。
- 使用Gradle Wrapper可以在没有安装Gradle的情况下运行Gradle构建，确保了构建环境的一致性。
gradlew 和 gradlew.bat:
- 这些是Gradle Wrapper的可执行脚本，用于在Unix和Windows系统上启动Gradle构建。
- gradlew是用于Unix-like系统的脚本，gradlew.bat是用于Windows系统的批处理文件。
README.md:
- 虽然这不是Gradle特定的文件，但它是一个很好的实践，用于提供项目的简要说明、如何构建项目和如何运行项目。

Gradle相关配置文件说明

build.gradle 示例:

plugins {id 'java'id 'org.springframework.boot' version '2.7.0'
}
repositories {mavenCentral()
}
dependencies {implementation 'org.springframework.boot:spring-boot-starter-web:2.7.0'testImplementation 'org.springframework.boot:spring-boot-starter-test:2.7.0'
}
jar {manifest {attributes 'Main-Class': 'com.example.MainClass'}
}

settings.gradle 示例:

rootProject.name = 'my-java-project'
include 'sub-project-1', 'sub-project-2'

gradle.properties 示例:

# Project-wide Gradle settings
org.gradle.jvmargs=-Xmx4608M -XX:MaxPermSize=512M -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
# Gradle metadata
org.gradle.wrapper.useGradleUserHomeForStorage=true

gradle-wrapper.properties 示例:

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

Gradle相关配置文件中代码语法说明

插件声明

plugins {id 'java'id 'org.springframework.boot' version '2.7.0'id 'io.spring.dependency-management' version '1.0.11.RELEASE'
}

plugins { ... }：这是一个在Gradle中声明插件的块。在这里，可以指定项目使用的插件及其版本。
id 'java'：应用Java插件，它添加了编译和测试Java源代码的能力。
id 'org.springframework.boot' version '2.7.0'：应用Spring Boot插件，它提供了Spring Boot项目的支持，并添加了额外的任务，如bootJar。
version：指定插件的版本。如果省略，Gradle将使用最新版本。

依赖配置

dependencies {implementation 'org.springframework.boot:spring-boot-starter-web:2.7.0'testImplementation 'org.springframework.boot:spring-boot-starter-test:2.7.0'
}

dependencies { ... }：这是一个配置项目依赖的块。
implementation：用于添加编译和运行时都需要的依赖。
testImplementation：用于添加测试编译时需要的依赖。
org.springframework.boot:spring-boot-starter-web:2.7.0：这是一个依赖项的声明，包括组ID、工件ID和版本。

任务配置

task myTask(type: JavaCompile) {source = 'src/main/java'classpath = sourceSets.main.runtimeClasspath
}

task myTask(type: JavaCompile) { ... }：定义一个新任务myTask，类型为JavaCompile。
source：设置源代码目录。
classpath：设置编译时使用的类路径。

属性配置

ext {set('myProperty', 'myValue')
}

ext { ... }：这是一个扩展属性块，用于定义项目级别的额外属性。例如java中的properties模块定义依赖的版本
set('myProperty', 'myValue')：定义一个名为myProperty的属性，值为myValue。

自定义任务

task customTask(type: Copy) {from 'src/main/resources'into 'build/resources/main'
}

task customTask(type: Copy) { ... }：定义一个新任务customTask，类型为Copy。
from：指定要复制的源目录或文件。
into：指定目标目录。

多项目构建

subprojects {apply plugin: 'java'repositories {mavenCentral()}dependencies {implementation 'commons-lang:commons-lang:2.6'}
}

subprojects { ... }：这是一个为所有子项目配置通用设置的块。
apply plugin: 'java'：为每个子项目应用Java插件。
repositories 和 dependencies：为每个子项目配置依赖仓库和依赖项。

使用Gradle Wrapper

Gradle Wrapper是一个脚本和库，它允许在没有预先安装Gradle的情况下运行Gradle构建。它的主要目的是为了确保项目构建的一致性，因为每个项目都可以附带其所需版本的Gradle Wrapper。这样，无论在什么环境下，无论是开发者机器、CI/CD服务器还是其他任何地方，都可以保证使用相同版本的Gradle来构建项目，从而减少了由于Gradle版本差异导致的问题。
Gradle Wrapper包括以下几个部分：

gradlew 和 gradlew.bat 脚本：
- gradlew 是用于Unix-like系统的Shell脚本。
- gradlew.bat 是用于Windows系统的批处理脚本。
- 这些脚本负责启动Gradle构建，并确保使用正确的Gradle版本。
gradle/wrapper/gradle-wrapper.jar：
- 这是一个Java库，包含了Gradle Wrapper的逻辑。
- 它由gradlew脚本使用来下载和运行Gradle发行版。
gradle/wrapper/gradle-wrapper.properties：
- 这是一个属性文件，用于配置Gradle Wrapper的行为。
- 它指定了要使用的Gradle版本、下载URL以及其他配置选项。
  使用Gradle Wrapper的好处包括：

易于安装：新加入项目的开发者不需要安装Gradle，只需使用项目自带的Wrapper。
版本控制：Gradle版本作为项目的一部分进行版本控制，确保了所有团队成员和构建服务器使用相同的Gradle版本。
性能优势：Gradle Wrapper可以缓存下载的Gradle发行版，因此不需要每次构建都重新下载。
灵活性：可以在不同的项目中使用不同版本的Gradle，而不会相互影响。

要为项目添加Gradle Wrapper，可以在项目根目录下运行以下命令：

gradle wrapper

这将生成上述提到的Wrapper脚本和配置文件。然后，可以通过执行./gradlew（在Unix-like系统上）或gradlew.bat（在Windows系统上）来运行Gradle构建，而不是直接运行gradle命令。

wrapper {gradleVersion = '7.3.3'distributionType = Wrapper.DistributionType.ALL
}

wrapper { ... }：配置Gradle Wrapper的块。
gradleVersion：指定Wrapper使用的Gradle版本。
distributionType：指定Wrapper下载的Gradle发行版类型，可以是BIN（二进制）或ALL（包括源代码和文档）。
这些语法说明提供了Gradle构建脚本中常见元素的基础知识。Gradle的灵活性允许根据项目的需求进行详细的配置和自定义。在实际项目中，可能需要根据具体情况调整和扩展这些基本的构建元素。

Gradle管理spingcloud代码示例

以下是一个基于Gradle的Spring Cloud订单项目的架构配置示例，包括父项目parent-service和两个子项目user-service、order-service。

父项目`parent-service`的`build.gradle`

//gradle
buildscript {repositories {mavenCentral()}dependencies {classpath 'org.springframework.boot:spring-boot-gradle-plugin:2.7.0'}
}
//所有项目统一配置
allprojects {group 'com.example'version '1.0-SNAPSHOT'repositories {mavenCentral()}
}
//统一版本依赖
ext {springBootVersion = '2.7.0'springCloudVersion = 'Hoxton.SR11'mybatisVersion = '2.2.0'nacosVersion = '2021.1'
}
//子项目管理配置
subprojects {apply plugin: 'java'apply plugin: 'org.springframework.boot'apply plugin: 'io.spring.dependency-management'sourceCompatibility = '1.8'targetCompatibility = '1.8'dependencies {implementation "org.springframework.boot:spring-boot-starter-web:${springBootVersion}"implementation "org.mybatis.spring.boot:mybatis-spring-boot-starter:${mybatisVersion}"implementation "com.alibaba.cloud:spring-cloud-starter-alibaba-nacos-discovery:${nacosVersion}"runtimeOnly 'mysql:mysql-connector-java'testImplementation "org.springframework.boot:spring-boot-starter-test:${springBootVersion}"}bootJar {baseName = project.nameversion = project.version}
}
// 子项目配置
project(':user-service') {dependencies {// user-service特定的依赖可以在这里添加，例如common包}
}
project(':order-service') {dependencies {// order-service特定的依赖可以在这里添加}
}

子项目`user-service`的`build.gradle`

// 应用父项目的配置
apply from: '../parent-service/build.gradle'
// 如果有特定于user-service的依赖，可以在这里添加
dependencies {// 例如，添加user-service特有的依赖，例如mysql驱动}

子项目`order-service`的`build.gradle`

// 应用父项目的配置
apply from: '../parent-service/build.gradle'
// 如果有特定于order-service的依赖，可以在这里添加
dependencies {// 例如，添加order-service特有的依赖
}

语法说明

buildscript { ... }：这是配置Gradle脚本自身使用的仓库和依赖的块。在这里，它配置了使用Maven Central作为仓库，并且依赖于Spring Boot的Gradle插件。
allprojects { ... }：为所有项目（包括子项目和根项目）设置一些共同的配置。这里定义了项目的组和版本，并指定了Maven Central作为依赖仓库。
ext { ... }：使用ext块定义统一的依赖版本。这有助于在多个项目中保持依赖版本的一致性。
subprojects { ... }：为所有子项目设置一些共同的配置。这里应用了Java、Spring Boot和Spring Dependency Management插件，并设置了Java编译的目标版本和源版本。还定义了一些共同的依赖，比如Spring Web Starter、MyBatis Starter、Nacos Discovery Starter、MySQL驱动和Spring Boot Test。
project(':user-service') { ... } 和 project(':order-service') { ... }：这些块用于为特定的子项目添加额外的配置，可以在这里添加特定于子项目的依赖或配置。

总结

Gradle是一个基于Groovy的自动化构建工具，广泛用于Java和Kotlin项目的构建。它提供了一种灵活的配置方式，支持多种语言和平台。以下是基于上述内容对Gradle的总结：

构建脚本：
- build.gradle：定义项目的构建配置，包括依赖、任务和插件。
- settings.gradle：定义项目中包含的模块。
- gradle.properties：设置项目构建时的全局属性。
依赖管理：
- 通过dependencies块，可以轻松地管理项目的依赖。
- 使用ext块可以统一依赖版本，保持项目间的一致性。
- dependencyManagement可以管理依赖版本，避免版本冲突。
插件和任务：
- plugins { ... }：声明项目使用的插件和版本。
- tasks { ... }：定义项目的构建任务。
多项目构建：
- allprojects { ... }：为所有项目设置通用配置。
- subprojects { ... }：为子项目设置通用配置。
Gradle Wrapper：
- 确保项目在不同环境下使用相同的Gradle版本。
- 无需安装Gradle即可运行项目。
构建生命周期：
- gradle build：构建项目。
- gradle clean：清理项目构建的输出。
- gradle tasks：列出项目中可用的任务。
  Gradle通过其强大的配置能力和灵活性，为Java项目提供了高效的构建和自动化解决方案。通过使用Gradle，开发者可以轻松地管理复杂的构建逻辑，并确保项目的质量和一致性。