【2】Gradle-快速入门使用【Gradle项目结构概念】

个人主页: 【⭐️个人主页】
需要您的【 点赞+关注】支持

---

【2】Gradle-快速入门使用【Gradle项目结构概念】

本文核心点：

• Gradle安装的条件
• Gradle的项目初始化命令
• Gradle的IDEA中使用
• Gradle Wrapper的概述
• Gradle的项目结构
• Gradle多模块
• settings.gradle和build.gradle文件的作用

安装

本地安装

您可以在Linux、macOS或Windows上安装Gradle Build Tool。

先决条件

Gradle在所有主要操作系统上运行。它需要Java开发工具包（JDK）版本8或更高版本才能运行。您可以查看兼容性矩阵以获取更多信息。

Gradle支持Kotlin和Groovy作为主要构建语言。Gradle有自己的Kotlin和Groovy库，因此不需要安装它们。

官网安装教程

不同的操作系统，使用不同的安装说明，我这里就不一一赘述了。安装软件工具，应该是一个软件开发人员最基本的能力。官网的安装教程是最新最可行的方案。所以自己摸索几分钟或1个小时，基本就安装成功

• 注意以下先决条件和gradle版本与java版本的对应关系。
  gradle 安装教程
  Gradle版本与Java等的兼容性

安装成功后，我们只要在系统中执行

gradle -v

gradle

Welcome to Gradle 8.4.

Directory '/' does not contain a Gradle build.

To create a new build in this directory, run gradle init

Gradle 快速指南

初始化项目

通过使用Gradle init创建Java应用程序来学习Gradle的基础知识。

• 初始化一个新的Gradle项目
  init:命令

  gradle init 
  kongxiang@kongxiangdeMacBook-Pro:gradle init
  Starting a Gradle Daemon, 3 incompatible Daemons could not be reused, use --status for details
  
  Select type of project to generate:
    1: basic
    2: application
    3: library
    4: Gradle plugin
  Enter selection (default: basic) [1..4] 2
  
  Select implementation language:
    1: C++
    2: Groovy
    3: Java
    4: Kotlin
    5: Scala
    6: Swift
  Enter selection (default: Java) [1..6] 3
  
  Generate multiple subprojects for application? (default: no) [yes, no] yes
  Select build script DSL:
    1: Kotlin
    2: Groovy
  Enter selection (default: Kotlin) [1..2] 2
  
  Project name (default: gradle-init-study): gradle-study
  Source package (default: gradle.study): com.kongxiang.study.gradle
  Enter target version of Java (min. 7) (default: 21): 20
  Generate build using new APIs and behavior (some features may change in the next minor release)? (default: no) [yes, no] no
  
  > Task :init
  To learn more about Gradle by exploring our Samples at https://docs.gradle.org/8.4/samples/sample_building_java_applications_multi_project.html
  
  BUILD SUCCESSFUL in 54s
  2 actionable tasks: 2 executed
  

查看Gradle的项目结构

探索Gradle文件并构建脚本

了解Gradle Wrapper

Gradle Wrapper是开始Gradle构建的首选方式。`Wrapper下载声明的特定版本的Gradle（如果需要），然后调用构建中声明的特定版本的Gradle。

在新创建的项目中，先看看Gradle Wrapper使用的文件。它由macOS和Linux的shell脚本以及Windows的批处理脚本组成。

这些脚本允许您运行Gradle构建，而无需在系统上安装Gradle。它还有助于确保同一版本的Gradle用于不同开发人员以及本地和CI机器之间的构建。

从现在开始，您永远不会直接调用Gradle；相反，您将使用Gradle包装器。

调用Gradle包装器

通过输入以下命令使用包装器：

$ ./gradlew build
在Windows中，命令是：
$ gradlew.bat build

第一次运行包装器时，如果Gradle二进制文件尚未安装在您的机器上，它会下载并缓存它们。

因为是国外网站，所以下载gradle非常慢，我们这里使用的是腾讯的镜像代理地址。
https\://mirrors.tencent.com/gradle/gradle-8.4-bin.zip

Gradle Wrapper旨在致力于源代码控制，以便任何人都可以构建项目，而无需首先安装和配置特定版本的Gradle。

在这种情况下，我们通过包装器调用Gradle来构建我们的项目，因此我们可以看到buildsrc目录现在包含一个新的build文件夹：

除非另有说明，否则构建过程生成的所有文件都会进入build目录。

了解Gradle的项目结构

构建包含：

• 顶级settings.gradle文件。
• 一个根项目。
• 一个或多个子项目，每个都有自己的build.gradle文件。

了解settings文件

一个项目由一个或多个子项目（有时称为模块）组成。

Gradle读取settings.gradle文件，以确定哪些子项目构成项目构建。

plugins {
    // Apply the foojay-resolver plugin to allow automatic download of JDKs
    id("org.gradle.toolchains.foojay-resolver-convention") version "0.7.0"
}

rootProject.name = "tutorial"
include("app")

tutorial根项目包括app子项目。include调用的存在将app目录变成一个子项目。

了解构建脚本

每个子项目都包含自己的build.gradle文件。
build.gradle 文件是构建过程的核心组件，定义了构建项目所需的任务。
build.gradle 文件由Gradle读取并执行。

plugins {
    id 'com.kongxiang.study.gradle.java-application-conventions'
}

dependencies {
    implementation 'org.apache.commons:commons-text'
    implementation project(':utilities')
}

application {
    // Define the main class for the application.
    mainClass = 'com.kongxiang.study.gradle.app.App'
}

此构建脚本让Gradle知道app子项目正在使用哪些依赖项和插件，以及在哪里可以找到它们。我们将在以下章节中更详细地研究这个问题。

IDEA中使用Gradle

idea中默认存在Gradle的插件。所以使用gradle创建项目是非常简单的事情。

创建一个新项目

创建一个Spring Boot 项目

Idea中 Gradle操作