理解 Gradle：build.gradle 常用配置
在使用 Gradle 时，build.gradle 文件是核心，它定义了项目的构建逻辑、依赖和任务。
1. build.gradle 文件的基础结构
build.gradle 是一个 Groovy 或 Kotlin DSL 脚本文件，以下是其基础结构：
plugins {
id 'java' // 应用Java插件
id 'application' // 用于构建可执行的Java应用程序
}
group = 'com.example' // 项目组名
version = '1.0.0' // 项目版本
repositories {
mavenCentral() // 指定依赖仓库
}
dependencies {
implementation 'org.springframework:spring-core:5.3.10' // 项目依赖
testImplementation 'junit:junit:4.13.2' // 测试依赖
}
tasks.register('customTask') {
doLast {
println 'Hello from custom task!'
}
}
每一部分都有明确的职责：
plugins：声明插件。group/version：定义项目的唯一标识。repositories：指定依赖的来源。dependencies：声明项目所需的依赖。tasks：自定义任务。
2. 常见配置详解
2.1 Plugins（插件管理）
Gradle 的强大离不开插件。常见插件包括：
Java 插件：id 'java'，提供 Java 项目构建的基础支持。Application 插件：id 'application'，用于构建可执行的 Java 应用。Kotlin 插件：id 'org.jetbrains.kotlin.jvm'，支持 Kotlin 项目。
示例：
plugins {
id 'java'
id 'org.springframework.boot' version '3.0.0' // Spring Boot 插件
}
2.2 Repositories（依赖仓库）
Gradle 支持多种仓库格式，最常见的是 Maven 和 JCenter。以下是几种配置方式：
repositories {
mavenCentral() // 官方 Maven 仓库
google() // Android 项目常用
maven { url 'https://jitpack.io' } // 自定义仓库
}
注意事项：优先选择可信赖的仓库来源，减少使用未经验证的第三方源。
2.3 Dependencies（依赖管理）
依赖声明通常分为以下几类：
implementation：编译时和运行时都需要的依赖。testImplementation：测试时需要的依赖。runtimeOnly：仅运行时需要的依赖。
示例：
dependencies {
implementation 'org.apache.commons:commons-lang3:3.12.0' // 编译与运行时依赖
testImplementation 'org.junit.jupiter:junit-jupiter:5.8.2' // 测试依赖
runtimeOnly 'mysql:mysql-connector-java:8.0.29' // 运行时依赖
}
小贴士：尽量避免 api（公开依赖）和 compile（已过时），使用更现代化的配置语义如 implementation 和 runtimeOnly。
2.4 Tasks（自定义任务）
Gradle 的任务系统非常强大，允许开发者定义构建逻辑。例如：
tasks.register('helloTask') {
doLast {
println 'Hello, Gradle!'
}
}
通过命令行运行：
gradle helloTask
复杂任务可以依赖其他任务或包含逻辑：
tasks.register('buildApp') {
dependsOn 'clean'
doLast {
println 'Building application...'
}
}
3. 常识与最佳实践
3.1 避免版本冲突
管理依赖时，多个库可能依赖不同版本的同一个库，造成冲突。可以通过以下方式解决：
configurations.all {
resolutionStrategy {
force 'org.apache.commons:commons-lang3:3.12.0'
}
}
或者使用 BOM（Bill of Materials）：
dependencies {
implementation platform('org.springframework.boot:spring-boot-dependencies:3.0.0')
}
3.2 使用 Gradle Wrapper
永远使用 Gradle Wrapper (gradlew) 来保证团队成员和 CI/CD 环境中使用一致的 Gradle 版本。生成 Wrapper：
gradle wrapper
3.3 抽取配置到独立文件
当项目变得复杂时，可以将配置分离到独立文件中，例如：
settings.gradle：管理子项目。gradle.properties：存储全局配置。
在 gradle.properties 中定义变量：
appName=MyApp
在 build.gradle 中引用：
println "Building project: $appName"
3.4 调优构建性能
启用并行构建：
gradle build --parallel
使用 Gradle 缓存：
org.gradle.caching=true
4. 结语
build.gradle 文件不仅是 Gradle 构建系统的核心，更是提升开发效率的关键。掌握其配置方法、优化技巧和常见实践，能帮助你在项目构建和管理中事半功倍。
如果你还没试过 Gradle 的某些功能，不妨从简单的任务入手，逐步扩展自己的工具箱！
参考链接
Gradle 官方文档Gradle 插件门户Spring Boot Gradle 插件