java-gradle

Java Gradle 技能

掌握 Java 项目的 Gradle 构建工具及 Kotlin DSL。

概述

此技能涵盖使用 Kotlin DSL 配置 Gradle，包括任务配置、使用目录管理依赖项、构建缓存优化以及 CI/CD 集成。

适用场景

在以下情况下使用：

• 配置 Gradle 构建（Kotlin DSL）
• 使用目录管理依赖项
• 优化构建性能
• 设置构建缓存
• 创建自定义任务

快速参考

// build.gradle.kts
plugins {
    java
    id("org.springframework.boot") version "3.2.1"
    id("io.spring.dependency-management") version "1.1.4"
}

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(21)
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-web")
    testImplementation("org.springframework.boot:spring-boot-starter-test")
}

tasks.withType<JavaCompile> {
    options.compilerArgs.addAll(listOf("-parameters", "-Xlint:all"))
    options.isFork = true
    options.isIncremental = true
}

tasks.test {
    useJUnitPlatform()
    maxParallelForks = Runtime.getRuntime().availableProcessors() / 2
}

版本目录

# gradle/libs.versions.toml
[versions]
spring-boot = "3.2.1"

[libraries]
spring-boot-web = { module = "org.springframework.boot:spring-boot-starter-web", version.ref = "spring-boot" }

[plugins]
spring-boot = { id = "org.springframework.boot", version.ref = "spring-boot" }

常用命令

gradle dependencies              # View dependencies
gradle dependencyInsight --dependency log4j  # Analyze dep
gradle build --scan              # Build scan
gradle build --build-cache       # Use cache
gradle wrapper --gradle-version 8.5  # Update wrapper

构建优化

// settings.gradle.kts
enableFeaturePreview("STABLE_CONFIGURATION_CACHE")

// Enable parallel and caching
org.gradle.parallel=true
org.gradle.caching=true

故障排查

问题	解决方案
构建缓慢	启用 --build-cache
版本冲突	使用 platform() 或 constraints
缓存问题	gradle --refresh-dependencies

使用方法

Skill("java-gradle")