编辑“︁Java Gradle”︁

= Java Gradle =

'''Gradle''' 是一个基于 [[Apache Ant]] 和 [[Apache Maven]] 概念的项目自动化构建工具，它使用一种基于 [[Groovy]] 或 [[Kotlin]] 的领域特定语言（DSL）来描述构建逻辑。Gradle 结合了 Maven 的依赖管理和 Ant 的灵活性，并引入了增量构建、多项目构建等高级特性，使其成为 Java 生态系统中广泛使用的构建工具之一。

== 介绍 ==
Gradle 的核心优势在于其高性能、可扩展性和灵活性。它使用有向无环图（DAG）来定义任务依赖关系，并支持增量编译，从而显著提升构建速度。Gradle 还支持多语言项目（如 Java、Kotlin、Scala），并兼容 [[Maven]] 和 [[Ivy]] 仓库。

Gradle 的主要特点包括：
* '''依赖管理'''：自动下载和管理项目依赖。
* '''增量构建'''：仅重新编译更改的部分，提高效率。
* '''多项目支持'''：轻松管理大型项目的模块化结构。
* '''插件系统'''：丰富的官方和社区插件（如 Java、Spring Boot、Android）。
* '''跨平台'''：支持 Windows、macOS 和 Linux。

== 安装与配置 ==
=== 安装 Gradle ===
Gradle 可以通过以下方式安装：

1. '''使用 SDKMAN!'''（推荐）：
<syntaxhighlight lang="bash">
sdk install gradle
</syntaxhighlight>

2. '''手动安装'''：
   * 下载 Gradle 发行版并解压。
   * 配置环境变量：
<syntaxhighlight lang="bash">
export PATH=$PATH:/path/to/gradle/bin
</syntaxhighlight>

验证安装：
<syntaxhighlight lang="bash">
gradle --version
</syntaxhighlight>

=== 初始化项目 ===
创建一个新的 Java 项目：
<syntaxhighlight lang="bash">
gradle init --type java-application
</syntaxhighlight>

== 基础构建脚本 ==
Gradle 使用 `build.gradle` 文件定义构建逻辑。以下是一个简单的 Java 项目配置示例：
<syntaxhighlight lang="groovy">
plugins {
    id 'java'
}

repositories {
    mavenCentral() // 使用 Maven 中央仓库
}

dependencies {
    implementation 'org.apache.commons:commons-lang3:3.12.0' // 添加依赖
    testImplementation 'junit:junit:4.13.2' // 测试依赖
}
</syntaxhighlight>

== 任务与构建生命周期 ==
Gradle 的构建过程由任务（Task）组成。以下示例定义一个自定义任务：
<syntaxhighlight lang="groovy">
task hello {
    doLast {
        println 'Hello, Gradle!'
    }
}
</syntaxhighlight>

运行任务：
<syntaxhighlight lang="bash">
gradle hello
</syntaxhighlight>

输出：
<pre>
> Task :hello
Hello, Gradle!
</pre>

=== 常用内置任务 ===
* `gradle build`：编译、测试并打包项目。
* `gradle clean`：删除构建目录。
* `gradle test`：运行单元测试。

== 依赖管理 ==
Gradle 支持声明式依赖管理。以下示例展示如何添加和管理依赖：
<syntaxhighlight lang="groovy">
dependencies {
    implementation 'com.google.guava:guava:31.1-jre' // 主代码依赖
    testImplementation 'org.junit.jupiter:junit-jupiter:5.8.1' // 测试依赖
}
</syntaxhighlight>

依赖配置类型：
* `implementation`：编译时依赖，不传递。
* `api`：编译时依赖，且传递。
* `compileOnly`：仅编译时使用。
* `runtimeOnly`：仅运行时使用。

== 多项目构建 ==
对于大型项目，可以使用多项目结构。以下是一个典型的多项目配置：
<pre>
root-project/
├── build.gradle
├── settings.gradle
├── core/
└── app/
</pre>

`settings.gradle` 文件：
<syntaxhighlight lang="groovy">
rootProject.name = 'my-project'
include 'core', 'app'
</syntaxhighlight>

根项目的 `build.gradle`：
<syntaxhighlight lang="groovy">
subprojects {
    apply plugin: 'java'
    repositories { mavenCentral() }
}
</syntaxhighlight>

== 实际案例 ==
=== Spring Boot 项目配置 ===
以下是一个 Spring Boot 项目的 Gradle 配置：
<syntaxhighlight lang="groovy">
plugins {
    id 'org.springframework.boot' version '2.7.0'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
    id 'java'
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}
</syntaxhighlight>

=== Android 项目配置 ===
Android 项目通常使用 `com.android.application` 插件：
<syntaxhighlight lang="groovy">
plugins {
    id 'com.android.application'
}

android {
    compileSdkVersion 31
    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 21
        targetSdkVersion 31
    }
}
</syntaxhighlight>

== 性能优化 ==
Gradle 提供了多种性能优化选项：
1. '''启用守护进程'''（默认开启）：
<syntaxhighlight lang="groovy">
org.gradle.daemon=true
</syntaxhighlight>

2. '''并行构建'''：
<syntaxhighlight lang="bash">
gradle build --parallel
</syntaxhighlight>

3. '''增量编译'''：
<syntaxhighlight lang="groovy">
tasks.withType(JavaCompile) {
    options.incremental = true
}
</syntaxhighlight>

== 常见问题与解决方案 ==
{| class="wikitable"
|-
! 问题 !! 解决方案
|-
| 依赖下载慢 || 使用国内镜像（如阿里云）
|-
| 构建速度慢 || 启用缓存和并行构建
|-
| 插件冲突 || 检查插件版本兼容性
|}

== 进阶主题 ==
* 自定义 Gradle 插件开发
* 使用 Kotlin DSL 编写构建脚本
* 集成持续集成（CI）工具（如 Jenkins、GitHub Actions）

== 总结 ==
Gradle 是一个功能强大且灵活的构建工具，适用于从简单到复杂的 Java 项目。通过合理的配置和优化，可以显著提升开发效率和构建性能。初学者应从基础构建脚本和依赖管理开始，逐步掌握多项目构建和高级特性。

== 参见 ==
* [[Apache Maven]]
* [[Groovy]]
* [[Kotlin]]

[[Category:编程语言]]
[[Category:Java]]
[[Category:Java最佳实践]]