java-gradle

Java Gradle スキル

Java プロジェクト向けの Gradle ビルドツールを、Kotlin DSL とともに使いこなします。

概要

このスキルでは、タスク設定、カタログを使った依存関係管理、ビルドキャッシュの最適化、CI/CD との統合など、Kotlin DSL による Gradle の設定を扱います。

このスキルを使うタイミング

次のような場合に使用します。

• 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")