小さく作り、
少しずつ育てる。

01今回やりたいこと

空のフォルダーに、これから作業を書き足していくGradleの最小構成を用意します。

02今、何が足りない？

まだWrapperがないので、最初のinitを動かすGradle本体が必要です。Gradleを動かすJDK 25と、作るプログラムをコンパイル・実行するJDK 11を準備します。Gradleは9.6.0のままです。Javaや起動の設定はまだ書きません。

03どこを変更する？

作業先は、これから作る空の SampleApp だけです。教材のHTMLを置いたフォルダーや、業務のプロジェクトを作業先にしないでください。

04PowerShellで用意する

1. JDKを確認。JAVA_HOMEが正しいJDK 25なら変更しません。次の枠をPowerShellで実行します。

$env:JAVA_HOME
Test-Path "$env:JAVA_HOME\bin\javac.exe"
& "$env:JAVA_HOME\bin\java.exe" -version
& "$env:JAVA_HOME\bin\javac.exe" -version

JAVA_HOMEが空、パスが違う、または25以外なら、次のパスを自分のJDK 25の場所へ置き換えます。bin の一つ上を指定し、上の確認をやり直してください。これは今開いているPowerShellだけの設定です。

$env:JAVA_HOME = 'C:\実際のインストール先\jdk-25'

アプリ用JDK 11も確認。次の仮パスを自分のJDK 11の場所へ置き換えます。JAVA_HOMEは25のままです。

$lessonJdk11 = 'C:\実際のインストール先\jdk-11'
Test-Path "$lessonJdk11\bin\javac.exe"
& "$lessonJdk11\bin\java.exe" -version
& "$lessonJdk11\bin\javac.exe" -version

両方のTest-PathがTrueで、Gradle用は25、アプリ用は11と表示されることを確認します。Eclipse本体を起動するJavaも別の役割です。Eclipse本体やGradleの起動JDKを11へ変更しません。

2. 初回のGradleを確認。PATHに登録済みなら gradle --version。未登録ならフルパスで実行できます。パスの引用符だけでなく、先頭の & も入力します。

$lessonGradle = 'C:\実際の展開先\gradle-9.6.0\bin\gradle.bat'
& $lessonGradle --version

--version はGradle自体の情報を表示するオプションで、Task名ではありません。コンパイルは行いません。表示されたGradleが9.6.0、Launcher JVMとDaemon JVMが25かを確認します。違う場合はJAVA_HOMEに加え、既存のorg.gradle.java.homeやDaemon JVM criteriaの指定も確認します。全PC共通のインストール先はありません。端末を開き直したら、この設定も確認し直します。

3. 空のフォルダーへ移動。次の親フォルダーは例です。自分の練習用フォルダーに置き換え、既にSampleAppがある場合は上書きせず別の空の親フォルダーを使います。

Set-Location 'C:\自分の練習用フォルダー'
New-Item -ItemType Directory -Name SampleApp
Set-Location SampleApp

4. 最小構成を生成。PATHでGradleを使える場合は次を実行します。Kotlin DSLが既定です。Groovyを選ぶ場合は、この時点で上部の切替を行ってください。

gradle init --type basic --dsl kotlin --project-name SampleApp --use-defaults

gradle init --type basic --dsl groovy --project-name SampleApp --use-defaults

フルパスを変数に入れた場合は、上のコマンドの代わりに次を実行します。両方を実行する必要はありません。

& $lessonGradle init --type basic --dsl kotlin --project-name SampleApp --use-defaults

& $lessonGradle init --type basic --dsl groovy --project-name SampleApp --use-defaults

init はプロジェクトのひな形を作るTaskです。ここでは --type basic で最小構成を選び、DSL・名前・既定値の使用を指定しています。設定ファイルとWrapperが生成されることを、次の一覧と照合します。Javaのコンパイルはまだ行いません。

05何が変わった？

gradle は導入済みのGradle本体を起動するコマンド。生成された gradlew.bat は、このプロジェクト指定のGradleを起動する入口です。以後はWrapperを使うため、本体の場所を毎回指定する必要はありません。

変更前は空のフォルダー、変更後は上の構成です。src はまだなく、Javaソースや子プロジェクトもありません。実行後に現れる .gradle/ はGradleの作業用データです。

01今回やりたいこと

第1章で作ったSampleAppをEclipseから編集・実行できるようにします。

02今、何が足りない？

ファイルはありますが、まだEclipseのワークスペースには登録していません。GradleはEclipseの外でも使えるので、取り込みとGradle自体の成功を分けて確認します。

03どこを変更する？

教材用フォルダーの中身は変更しません。Eclipseへ既存の SampleApp の場所を指定します。新規Gradle Projectウィザードは使いません。

04Eclipseで操作する

1. Eclipseで File → Import… → Gradle → Existing Gradle Project → Next。Welcome画面が出た場合は案内を進めます。Gradle項目がなければBuildshipの導入状態を確認します。
2. Project root directoryには、第1章の SampleApp を選択します。src や gradle/wrapper ではありません。NextでImport Optionsへ進みます。
3. Override workspace settings をオンにし、この教材の取り込みに使う設定を下の順に確認します。既定値は以前の操作やワークスペースによって異なります。

1. NextでPreview（表示される場合）を確認し、Finish。同期が終わるまで待ちます。
2. Project ExplorerにSampleAppが現れ、settingsとbuildファイルが見えることを確認します。設定ファイルが編集画面で開かない場合は、右クリック → Open With → Text Editor を選びます。
3. Window → Show View → Other… → Gradle → Gradle Tasks を開き、SampleAppの help をダブルクリック。結果はGradle Consoleで読みます。Task一覧が古ければ、プロジェクトを右クリック → Gradle → Refresh Gradle Project。

05何が変わった？

.\gradlew.bat help
.\gradlew.bat tasks
.\gradlew.bat projects

./gradlew help
./gradlew tasks
./gradlew projects

help は使い方の案内を表示し、この場所でGradleが起動して設定を読めるかを確認します。tasks は主なTaskの一覧で「今頼める仕事」を、projects はプロジェクトの一覧で「どの構成を開いているか」を確認します。いずれもJavaをコンパイルする指示ではありません。

まだJava Pluginを使っていないため、Java用のソースフォルダーやJRE System Libraryの表示がなくても異常ではありません。compileJava やJava用の build Taskはまだ登録されていません。

01今回やりたいこと

Gradleプロジェクトは作れた。でも、Javaをコンパイルするには？

02今、何が足りない？

まだJava用のTaskとJavaソースがありません。ここで初めてjava Pluginを追加します。

03どこを変更する？

SampleApp直下の build.gradle.kts にpluginsとToolchain 11を追加します。生成時のコメントは残しても構いません。新規ファイルは src/main/java/guide/Greeting.java です。

plugins {
    java
}

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

plugins {
    id 'java'
}

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

今回のプログラムはJava 11で動かすため、Toolchainでコンパイルに使うJDKを11に指定します。Gradleを動かすJDK 25は変えません。選ばれたJDKを詳しく確認するのは第9章です。

.\gradlew.bat -q javaToolchains

./gradlew -q javaToolchains

org.gradle.java.installations.paths=C:/実際のインストール先/jdk-11

04Eclipseで操作する

Java Pluginには標準の約束（既定のフォルダー構成）があります。下の場所を用途に合わせて使えば、フォルダーを作るたびにbuildファイルへソースパスを書く必要はありません。標準以外の配置は sourceSets などで変更できます。

1. build.gradle.kts を開き、上の設定を入力します。設定ファイルが編集画面で開かない場合は、右クリック → Open With → Text Editor を選びます。
2. 保存（Ctrl+S）し、SampleAppを右クリック → Gradle → Refresh Gradle Project。同期が終わるまで待ちます。
3. Properties → Java Build Path → Libraries のJRE System LibraryがJavaSE-11（またはJDK 11）、Java Compiler の準拠レベルが11か確認します。違う場合は第9章の確認手順へ。
4. SampleAppを右クリック → New → Folder（なければOther… → General → Folder）。src/main/java を作成します。中間フォルダーをまとめて作れない場合はsrc、main、javaの順に作成します。
5. もう一度Gradle Refresh。src/main/java がJavaのソースフォルダーとして認識されるか、Properties → Java Build Path → Source で確認します。手動のJAR登録や別のJava Project作成は不要です。
6. そのソースフォルダーを右クリック → New → Class。Packageは guide、Nameは Greeting。作成された内容を次の全文に置き換え、保存します。

package guide;

public class Greeting {
    public static String message(String name) {
        return "Hello, " + name + "!";
    }

    public static void main(String[] args) {
        System.out.println(message("Gradle"));
    }
}

Eclipseの「Run As → Java Application」を使う前に、Gradleでコンパイルできるかを確認します。まだGradleから起動する設定はしていません。

05何が変わった？

最初の1行は、.\gradlew.bat（WrapperからGradleを起動）＋ tasks（実行するTask名）＋ --all（一覧を詳しくするオプション）に分かれます。以下は役割と結果を比べるため、教材で個別に実行します。

.\gradlew.bat tasks --all
.\gradlew.bat compileJava
.\gradlew.bat classes
.\gradlew.bat jar
.\gradlew.bat build

./gradlew tasks --all
./gradlew compileJava
./gradlew classes
./gradlew jar
./gradlew build

classes 自身がJavaを変換するのではなく、compileJava と processResources に依存して準備をまとめます。後者は src/main/resources のファイルを出力先へコピーするTaskです。今はリソースがないため processResources NO-SOURCE で問題ありません。

Gradle TasksビューはRefreshしてから見ます。Gradleを導入しても、Eclipseの通常ビルドは使います。ただし、Ctrl+B とGradleの build は同じ操作ではありません。

IDEでエラーが消えても、Gradleのbuildが成功したことにはなりません。ここではGradleの出力を確認します。設定画面の使い分けは第9章で扱います。

01今回やりたいこと

Javaをコンパイルできるようになった。では、mainをGradleから実行するには？

02今、何が足りない？

java Pluginだけではrun Taskがありません。起動するクラスの指定も必要です。

03どこを変更する？

build.gradle.kts の plugins 内のjavaをapplicationへ置換し、applicationブロックを追加します。第3章のToolchain 11は残します。Greeting.javaは変更しません。

plugins {
    java
}

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

plugins {
    id 'java'
}

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

plugins {
    application
}

application {
    mainClass = "guide.Greeting"
}

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

plugins {
    id 'application'
}

application {
    mainClass = 'guide.Greeting'
}

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

application PluginはJavaの機能を含みます。javaとapplicationの両方を並べて書く必要はありません。mainClass はパッケージを含むクラス名です。

04Eclipseで操作する

1. Eclipseでpluginsを置換し、Toolchain 11を残したままapplicationブロックを追加。
2. 保存（Ctrl+S）し、SampleAppを右クリック → Gradle → Refresh Gradle Project。同期が終わるまで待ちます。
3. Gradle Tasksのapplicationグループから run を実行。端末でも、SampleAppのルートで次を実行します。

.\gradlew.bat run
.\gradlew.bat build

./gradlew run
./gradlew build

05何が変わった？

今回のrunもToolchainで選んだJDK 11を使います。Eclipseの Run As → Java Application は別の実行構成なので、第9章の手順でJDK 11を選んでください。applicationでは配布用のTaskも追加されます。通常のJARは依存をすべて内蔵する実行JARではないため、java -jar で必ず起動できるとは考えません。

.\gradlew.bat installDist

./gradlew installDist

01今回やりたいこと

自分で追加したpluginsとapplicationを読み、成果物の名前を変える設定を見つけます。

02今、何が足りない？

今はSampleApp.jarという名前です。版を付けるためのversionはまだ指定していません。

03どこを変更する？

build.gradle.kts の末尾へversionを1行追加します。settings.gradle.kts のSampleAppという名前は変更しません。

version = "1.0"

version = '1.0'

plugins { application }

plugins { id 'application' }

application { mainClass = "guide.Greeting" }

application { mainClass = 'guide.Greeting' }

version = "1.0"

version = '1.0'

04Eclipseで操作する

1. Eclipseでbuildファイルのpluginsとapplicationの範囲を確認します。波括弧の外へversionを追加して保存します。
2. 保存（Ctrl+S）し、SampleAppを右クリック → Gradle → Refresh Gradle Project。同期が終わるまで待ちます。
3. Gradle Tasksで jar を実行するか、下のコマンドを使います。

.\gradlew.bat jar

./gradlew jar

versionを保存しただけでは、既存のJARの名前は変わりません。jar をもう一度実行し、新しい版を名前に含むJARを作ります。

05何が変わった？

plugins {
    application
}

application {
    mainClass = "guide.Greeting"
}

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

version = "1.0"

plugins {
    id 'application'
}

application {
    mainClass = 'guide.Greeting'
}

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

version = '1.0'

01今回やりたいこと

buildを頼むと何が対象になるのか、実際に作ったSampleAppで確認します。

02今、何が足りない？

compileJava・jar・runは試しましたが、buildがまとめる作業の関係はまだ見ていません。

03どこを変更する？

設定ファイルは変更しません。第5章の内容を保ち、指定するTaskだけを変えて調べます。

• 白系：処理するコンパイル・コピー・JAR作成・テスト
• 薄緑：まとめる必要なTaskを実行対象にする
• 濃緑：build作成と検証をまとめる入口

このTaskは何をしている？

薄緑の4つと濃緑のbuildは、いずれも「まとめるTask」です。通常は自分でコンパイル等をせず、依存するTaskを実行対象にします。濃緑は全体の入口を強調したもので、別種のTaskという意味ではありません。

04EclipseとPowerShellで確認する

EclipseのGradle Tasksでbuild・assemble・check・cleanを探します。Task一覧は端末の tasks --all、testの説明と利用できるオプションは help --task test で確認できます。次はSampleAppのルートで、同じbuildを3つの方法で比べます。

# 通常のビルド
.\gradlew.bat build

# 実行計画に含まれるTaskを確認
.\gradlew.bat build --dry-run --console=plain

# Taskごとの実行状況を詳しく確認
.\gradlew.bat build --console=verbose

# 通常のビルド
./gradlew build

# 実行計画に含まれるTaskを確認
./gradlew build --dry-run --console=plain

# Taskごとの実行状況を詳しく確認
./gradlew build --console=verbose

通常のbuildでは、端末やコンソール表示の設定によってTask名が省略される場合があります。表示されないことは「Taskが動いていない」という意味ではありません。最後のverboseコマンドをもう一度実行し、入力・出力が変わらないTaskの UP-TO-DATE を確認しましょう。この章にはテストソースがないので、testは NO-SOURCE です。

dry-runの :compileJava SKIPPED は、実行計画の確認のためTaskの処理を行っていないという意味です。コンパイルやテストが成功した証拠ではありません。先頭の : はこのプロジェクトのTaskパスです。applicationの配布用Taskなど、図で省略した名前も表示されます。観察した並びを、独立したTask同士の固定的な実行順序とは考えません。

キャッシュと表示は別の話です。Reusing configuration cache. / Configuration cache entry reused. は、ビルド設定の結果を再利用したという意味です。UP-TO-DATE はTaskの入力・出力の状態から処理を省略できる状態、--console はログの表示方法です。設定を再利用しても必要なTaskは実行されます。末尾が 3 executed なら3個のTaskの処理が実際に行われています。

Reusing configuration cache.
…（中略）
> Task :compileJava UP-TO-DATE
> Task :classes UP-TO-DATE
> Task :compileTestJava NO-SOURCE
…（中略）
> Task :test NO-SOURCE
…（中略）
5 actionable tasks: 5 up-to-date
Configuration cache entry reused.

05何が変わった？

Taskが存在することと、処理するソースがあることは別です。第8章まではテストソースがないため、通常のbuildを実行してもtestは NO-SOURCE になります。次はdry-runではなく、verboseで実作業を頼んだ場合に読み取る表示例です。

変更前後で設定は同じです。buildとtestでは対象のTaskが違い、buildにcleanは含まれません。clean は通常、このプロジェクトのbuild/を削除します（ソースは残ります）。生成物からやり直す必要があるときだけ clean build を使います。

01今回やりたいこと

小文字のgradleを渡しても、先頭を大文字にして挨拶したい。Commons Lang 3.20.0のStringUtilsを使います（Java 8以上に対応するため、Java 11で利用できます）。

02今、何が足りない？

外部ライブラリの取得先と依存の指定がなく、Javaコードもそのライブラリをまだ呼んでいません。

03どこを変更する？

build.gradle.kts の既存のplugins・application・Toolchain 11・versionは残し、末尾に次を追加します。ここで初めてrepositoriesとdependenciesを使います。

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.apache.commons:commons-lang3:3.20.0")
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.apache.commons:commons-lang3:3.20.0'
}

04Eclipseで操作する

1. Eclipseでbuildファイルへ上の2ブロックを追加。
2. 保存（Ctrl+S）し、SampleAppを右クリック → Gradle → Refresh Gradle Project。同期が終わるまで待ちます。
3. src/main/java/guide/Greeting.java を次の全文へ置き換えて保存。入力も Gradle から gradle へ変わることを確認します。

package guide;

import org.apache.commons.lang3.StringUtils;

public class Greeting {
    public static String message(String name) {
        return "Hello, " + StringUtils.capitalize(name) + "!";
    }

    public static void main(String[] args) {
        System.out.println(message("gradle"));
    }
}

.\gradlew.bat run
.\gradlew.bat dependencies --configuration runtimeClasspath
.\gradlew.bat dependencyInsight --dependency commons-lang3 --configuration runtimeClasspath

./gradlew run
./gradlew dependencies --configuration runtimeClasspath
./gradlew dependencyInsight --dependency commons-lang3 --configuration runtimeClasspath

dependencies は依存の一覧、dependencyInsight は指定した依存の経路と版が選ばれた理由を表示します。--configuration runtimeClasspath で実行時の依存に絞り、後者は --dependency commons-lang3 で調査対象も絞ります。表示された版が3.20.0かを確認します。

05何が変わった？

mavenCentral() は取得先、implementation は本番コードの実装で利用する依存です。座標は group:artifact:version。宣言だけでJavaの動きは変わりません。コードで実際に呼び出して初めて機能が変わります。

plugins {
    application
}

application {
    mainClass = "guide.Greeting"
}

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

version = "1.0"

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.apache.commons:commons-lang3:3.20.0")
}

plugins {
    id 'application'
}

application {
    mainClass = 'guide.Greeting'
}

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

version = '1.0'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.apache.commons:commons-lang3:3.20.0'
}

01今回やりたいこと

「gradleを渡すとHello, Gradle!が返る」を自動で確かめます。

02今、何が足りない？

test Taskはありますが、テストソースがないのでNO-SOURCEです。JUnitと実行設定もまだありません。JUnit 5.13.4はJava 8以上に対応し、今回のtestは既存のToolchainに従ってJDK 11で実行します。

03どこを変更する？

JUnitは複数の関連モジュールからできています。版を一つずつ指定すると手間がかかり、組み合わせが合わなくなることもあります。そこで、関連部品の推奨バージョンをまとめた BOM（Bill of Materials） を使います。「揃える」は、すべて同じ番号にする意味ではありません。

build.gradle.kts の既存の dependencies を次の形にします。Commons Langを残し、testImplementationの2行とtestRuntimeOnlyの1行を追加します。dependenciesブロックをもう一つ作る必要はありません。

dependencies {
    implementation("org.apache.commons:commons-lang3:3.20.0")

    testImplementation(platform("org.junit:junit-bom:5.13.4"))
    testImplementation("org.junit.jupiter:junit-jupiter")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

dependencies {
    implementation 'org.apache.commons:commons-lang3:3.20.0'

    testImplementation platform('org.junit:junit-bom:5.13.4')
    testImplementation 'org.junit.jupiter:junit-jupiter'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

platform("org.junit:junit-bom:5.13.4") はBOMをバージョン管理情報として取り込み、そこにある指定を依存解決に使います。そのため、junit-jupiterとjunit-platform-launcherには個別の版を書かずに済みます。前者はテスト用の部品、後者は実行側の部品です。

対象はBOMに定義されたライブラリです。すべての依存の版を揃える機能ではなく、通常のplatformは絶対固定でもありません。他の依存指定との競合で最終的な選択が変わる場合があります。

次のtest設定は、dependenciesの閉じ括弧より後（ブロックの外）に置きます。useJUnitPlatform() はtestにJUnit Platformを使わせる指定です。

tasks.test {
    useJUnitPlatform()
}

tasks.named('test') {
    useJUnitPlatform()
}

第3章の標準の約束により、src/test/java はGradle側でテスト用に設定済みです。Eclipseのソースフォルダー表示は別で、BuildshipのRefreshがGradleの構成を読み、IDEへ反映します。次のフォルダー作成後にもRefreshするのはこのためです。

04Eclipseで操作する

1. Eclipseで上の設定を追加。保存（Ctrl+S）し、SampleAppを右クリック → Gradle → Refresh Gradle Project。同期が終わるまで待ちます。
2. New → Folderで src/test/java を作り、Gradle Refresh。テスト用ソースとしての認識をJava Build Pathで確認します。
3. src/test/java にPackage guide、Class GreetingTest を作り、下の内容へ置換して保存します。
4. Gradle Tasksの test を実行。Eclipse独自のJUnit実行と混同せず、まずGradleの結果を見ます。

package guide;

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

class GreetingTest {
    @Test
    void greetsWithCapital() {
        assertEquals("Hello, Gradle!", Greeting.message("gradle"));
    }
}

.\gradlew.bat test
.\gradlew.bat test --tests "guide.GreetingTest.greetsWithCapital" --rerun-tasks

./gradlew test
./gradlew test --tests "guide.GreetingTest.greetsWithCapital" --rerun-tasks

1行目の test はテストを実行します。2行目は --tests で指定したクラス・メソッドに絞り、--rerun-tasks で変更なしによる省略を避け、必要な先行Taskも含めてやり直します。結果は次のレポートで確認します。

05何が変わった？

build/reports/tests/test/index.html をブラウザで開きます。Eclipseでbuildフォルダーが見えなければ、OSのエクスプローラーからSampleAppを開いてください。XMLは build/test-results/test/ です。

失敗も一度体験：テストの期待値だけをHello, Wrong!へ変え、保存して再実行します。失敗のexpectedとactualを読み、Hello, Gradle!へ戻して再実行してください。UP-TO-DATEで省略される場合は上の--rerun-tasksを使います。

plugins {
    application
}

application {
    mainClass = "guide.Greeting"
}

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

version = "1.0"

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.apache.commons:commons-lang3:3.20.0")
    testImplementation(platform("org.junit:junit-bom:5.13.4"))
    testImplementation("org.junit.jupiter:junit-jupiter")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

tasks.test {
    useJUnitPlatform()
}

plugins {
    id 'application'
}

application {
    mainClass = 'guide.Greeting'
}

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

version = '1.0'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.apache.commons:commons-lang3:3.20.0'
    testImplementation platform('org.junit:junit-bom:5.13.4')
    testImplementation 'org.junit.jupiter:junit-jupiter'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

tasks.named('test') {
    useJUnitPlatform()
}

01今回やりたいこと

第3章で指定したToolchain 11が、コンパイル・テスト・runに使われているかを確認します。

02今、何が足りない？

Gradleの起動Javaとアプリ用Javaは別です。--versionに25と出ても、アプリを25でコンパイルしているとは限りません。今回は起動用25、アプリ用11という役割を実行ログで区別します。

03どこを変更する？

設定は追加しません。SampleAppの build.gradle.kts に第3章からの次のブロックがあることを確認します。二重に書かないでください。

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

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

04Eclipseで操作する

1. ToolchainのlanguageVersionが11であることを確認。保存（Ctrl+S）し、SampleAppを右クリック → Gradle → Refresh Gradle Project。同期が終わるまで待ちます。
2. 下のコマンドをSampleAppのルートで実行。Gradleの起動Javaと、コンパイル・テスト・runの使用Javaを別々に確認します。
3. JDK 11が未検出なら第3章の補足へ戻ります。ログで11を使ったと確認できるまでは、成功表示だけで完了と判断しません。

.\gradlew.bat --version
.\gradlew.bat -q javaToolchains
.\gradlew.bat compileJava --info --rerun-tasks
.\gradlew.bat test --info --rerun-tasks
.\gradlew.bat build
.\gradlew.bat run --info

./gradlew --version
./gradlew -q javaToolchains
./gradlew compileJava --info --rerun-tasks
./gradlew test --info --rerun-tasks
./gradlew build
./gradlew run --info

javaToolchains は検出したJava環境の一覧です（-q は通常の進捗ログを抑制）。一覧にあるだけでは、選ばれた証拠にはなりません。--info で使用した実行ファイルを調べます。--rerun-tasks は変更なしによる省略を避け、今回のコンパイルやテストを観察するための指定です。

ログ表記は環境で変わります。testがUP-TO-DATEなどで省略された場合は、再実行してJavaプロセスの起動行を確認します。必要なら表示されたjava.exeをフルパスで -version 実行して11か照合してください。

& "$lessonJdk11\bin\javap.exe" -verbose .\build\classes\java\main\guide\Greeting.class | Select-String "major version"

05何が変わった？

Project Propertiesでは、何を設定する？

1. Window → Preferences → Java → Installed JREs → Add… → Standard VM で、JRE homeにJDK 11の場所を登録します。既存のJDK 25を削除したり、Eclipse本体の起動設定を変えたりしません。
2. Gradle Refresh後、SampleAppの Properties → Java Build Path → Libraries でJRE System LibraryがJavaSE-11（またはJDK 11）、Java Compiler で準拠レベルが11か確認します。JavaSE-11の対応先は Preferences → Java → Installed JREs → Execution Environments で登録したJDK 11と照合します。
3. 11にならないときは、保存済みのToolchain、GradleによるJDK 11の検出、Buildshipの同期結果を確認して再Refreshします。Java Build Pathだけを25から書き換えて解決したことにしません。
4. Run → Run Configurations… → Java Application でGreetingの構成を選び、JRE → Alternate JRE に登録したJDK 11を指定してApply → Run。構成がなければJava Applicationで新規作成し、Project=SampleApp、Main class=guide.Greetingを指定します。
5. GradleのImport / Properties → GradleのJava homeはJDK 25を維持します。EclipseのJava CompilerはIDE側のコンパイル設定であり、GradleのJDK 11のjavacそのものを呼ぶ設定ではありません。

Gradleのビルドに必要な設定は、基本的にGradle側へ。Eclipseだけの編集・表示設定は、Eclipse側へ。まずこの2つに分けて考えます。

Eclipseの自動ビルドやエラー表示は引き続き使えますが、Gradleのbuildとは別です。Gradle側を変更したら保存し、Refresh Gradle Project でEclipseへ反映します。Java Build Path で内容を確認できますが、Gradle管理の項目をEclipse側だけで変えてもGradleのビルド定義には反映されません。

4つの操作を使い分ける

EclipseのCleanとGradleのcleanは同じ処理ではありません。Refreshもbuild Taskを頼む操作とは異なります。Buildship・Eclipseの版や、追加ビルダー・同期時Task等の設定によって、付随する処理が動く場合はあります。

起動も区別：Run As → Java Application はIDEの実行設定・classpathを使います。Gradleの run はApplication PluginのTaskで、mainClassや実行時依存等の設定を使います。同じmainでも、JDK・引数・環境変数等が一致するとは限りません。

plugins {
    application
}

application {
    mainClass = "guide.Greeting"
}

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

version = "1.0"

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.apache.commons:commons-lang3:3.20.0")
    testImplementation(platform("org.junit:junit-bom:5.13.4"))
    testImplementation("org.junit.jupiter:junit-jupiter")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

tasks.test {
    useJUnitPlatform()
}

plugins {
    id 'application'
}

application {
    mainClass = 'guide.Greeting'
}

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

version = '1.0'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.apache.commons:commons-lang3:3.20.0'
    testImplementation platform('org.junit:junit-bom:5.13.4')
    testImplementation 'org.junit.jupiter:junit-jupiter'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

tasks.named('test') {
    useJUnitPlatform()
}

01今回やりたいこと

今の挨拶アプリを、起動するappと、名前を整えるcommonの2つへ分けます。

02今、何が足りない？

これまではSampleApp一つに全部ありました。ここで初めて、参加するプロジェクトと、その間の依存を定義します。

03どこを変更する？

元のSampleAppを比較用に残すため、練習用の隣のフォルダー SampleSystem にコピーを作ります。SampleApp自体は変更しません。

第1〜9章はSampleApp、第10章からはSampleSystemが作業先です。OSのエクスプローラーでSampleAppと同じ親フォルダーに空のSampleSystemを作り、まず次のファイルだけを同じ相対位置へコピーします。

コピーしないもの：.gradle/、build/、.project、.classpath、.settings/。ドットなしの gradle/wrapper/ はWrapperの部品、ドット付きの .gradle/ は作業用データです。

この演習では版をbuildファイルに直接書くため、生成済みの gradle/libs.versions.toml は使いません。.gitignore・.gitattributes も演習の実行には不要なのでコピーしません。src/ は次の手順でコピーします。

1. SampleSystemに app と common フォルダーを作成。SampleAppの src/ を SampleSystem/app/src/ へコピーし、テストも維持します。
2. SampleSystem直下の settings.gradle.kts を下の内容へ置換。build.gradle.kts は下のコメントだけに置換します。appとcommonにそれぞれ build.gradle.kts を新規作成します。

rootProject.name = "SampleSystem"
include("app", "common")

rootProject.name = 'SampleSystem'
include 'app', 'common'

// 共通の作業はまだ定義しない

// 共通の作業はまだ定義しない

plugins { application }
version = "1.0"
repositories { mavenCentral() }
java { toolchain { languageVersion = JavaLanguageVersion.of(11) } }
application { mainClass = "guide.Greeting" }
dependencies {
    implementation(project(":common"))
    testImplementation(platform("org.junit:junit-bom:5.13.4"))
    testImplementation("org.junit.jupiter:junit-jupiter")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}
tasks.test { useJUnitPlatform() }

plugins { id 'application' }
version = '1.0'
repositories { mavenCentral() }
java { toolchain { languageVersion = JavaLanguageVersion.of(11) } }
application { mainClass = 'guide.Greeting' }
dependencies {
    implementation project(':common')
    testImplementation platform('org.junit:junit-bom:5.13.4')
    testImplementation 'org.junit.jupiter:junit-jupiter'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}
tasks.named('test') { useJUnitPlatform() }

plugins { id("java-library") }
repositories { mavenCentral() }
java { toolchain { languageVersion = JavaLanguageVersion.of(11) } }
dependencies {
    implementation("org.apache.commons:commons-lang3:3.20.0")
}

plugins { id 'java-library' }
repositories { mavenCentral() }
java { toolchain { languageVersion = JavaLanguageVersion.of(11) } }
dependencies {
    implementation 'org.apache.commons:commons-lang3:3.20.0'
}

appはapplication、commonはライブラリを作るjava-libraryです。Commons Langはcommonの内部実装へ移し、appはcommonに依存します。include は参加者の登録、project(":common") は利用関係の指定です。

04Eclipseで操作する

1. 第2章と同じImport手順で SampleSystem を取り込みます。WrapperとGradle起動用JDK 25を指定。app/commonのToolchainは両方11です。Refresh後は両ProjectのJRE System Library・Java Compilerと、appのJava Application実行構成も第9章と同じく11か確認。以後この章の作業先はコピー側です。
2. appのGreeting.javaを下の全文へ置換。コピーしたGreetingTest.javaは変更しません。
3. commonに src/main/java を作成してRefresh。Package guide、Class NameFormatterを作成し、下の全文を保存します。
4. SampleSystemをGradle Refresh。端末もSampleSystemのルートへ移動して実行します。

package guide;

public class Greeting {
    public static String message(String name) {
        return "Hello, " + NameFormatter.format(name) + "!";
    }
    public static void main(String[] args) {
        System.out.println(message("gradle"));
    }
}

package guide;

import org.apache.commons.lang3.StringUtils;

public class NameFormatter {
    public static String format(String name) {
        return StringUtils.capitalize(name);
    }
}

先に作業場所をSampleSystemへ切り替える

Eclipseで開く対象も、端末の作業場所も SampleSystem です。下の親フォルダーを自分の配置に置き換えて実行し、表示された現在位置の末尾がSampleSystemか確認します。

Set-Location 'C:\自分の練習用フォルダー\SampleSystem'
Get-Location

cd '/自分の練習用フォルダー/SampleSystem'
pwd

次にSampleSystem直下の settings.gradle.kts を開き、rootProject.name がSampleSystem、include の対象がappとcommonであることを確認します。両フォルダーもSampleSystem直下にあることを確かめてから、構成を表示します。

.\gradlew.bat projects

./gradlew projects

projects は、今開いているGradleビルドに含まれるプロジェクト構成を表示するTaskです。ルートがSampleSystemで、子プロジェクト :app と :common が両方あることを確認します。

上の表は出力の要点です。実際のログの書式とは異なります。フォルダーが欠けている場合は、一覧ではなくエラーになることもあります。

.\gradlew.bat :app:build --info --rerun-tasks
.\gradlew.bat :app:run --info
.\gradlew.bat :common:dependencies --configuration runtimeClasspath

./gradlew :app:build --info --rerun-tasks
./gradlew :app:run --info
./gradlew :common:dependencies --configuration runtimeClasspath

:app:build は、:app＝ルート配下の子プロジェクトapp、build＝そのTask名をコロンでつないだTaskパスです。必要なcommon側のTaskも依存関係に応じて実行対象になります。:app:run はappの起動、:common:dependencies はcommonの依存調査です。結果は対象Projectのbuild/やコンソールで確認します。今回は--infoでapp/common両方のコンパイル用JDK 11、appのテストとrunのjava.exeがJDK 11か照合します。--rerun-tasksは観察のための再実行指定です。

05何が変わった？

Eclipseに複数のプロジェクト名が見えるのは、それぞれがGradleの参加プロジェクトとして取り込まれるためです。以前見た SampleApp と lib のような表示も、ルートと子プロジェクトの構成なら同じ理由です。表示順・階層はビュー設定で変わります。

ルートbuildの設定は自動ではapp・commonへ継承されません。appの成果物・レポートは app/build/ にあります。commonのAPIに外部型を公開するときの api の使い分けは発展的な確認事項です。

01今回やりたいこと

初めて参加するGradleプロジェクトで、実行する場所と変更するファイルを自分で探します。

02今、何が足りない？

知っている設定でも、置かれた場所や指定された版は案件ごとに異なります。まず構成を読むための順番を決めます。

03どこを変更する？

最初は何も書き換えません。練習では第10章のSampleSystemを受け取った案件と見立てます。業務案件ではREADMEとチームの手順を優先し、教材の版へ勝手に変更しません。

04Eclipseで操作する

1. Import前にREADMEとWrapperの版を読み、settingsの場所からルートを決めます。信頼できるプロジェクトであることを確認してからGradleを実行します。
2. settingsで参加者、各buildでPlugin・依存・Toolchainを確認します。sampleの知識だけで全構成を決めつけません。
3. EclipseへImportし、Gradle TasksとGradle Consoleを確認。依存を変更するなら、対象ソースが属するbuildファイルを選びます。
4. 実践問題：commonの内部で使うライブラリの版を変える依頼が来ました。変更前に、対象ファイル、使うWrapper、確認するTaskとレポートの場所をメモしてください。

.\gradlew.bat --version
.\gradlew.bat projects
.\gradlew.bat :app:tasks --all
.\gradlew.bat :common:dependencies --configuration runtimeClasspath

./gradlew --version
./gradlew projects
./gradlew :app:tasks --all
./gradlew :common:dependencies --configuration runtimeClasspath

05何が変わった？

この演習では--versionに25と出るのが正常で、アプリの11は各buildのToolchainと実行ログで確認します。構成確認だけではファイルは変わりません。失敗を見つけたら、失敗Task・最初の原因・ファイルと行番号を読みます。IDEとGradleでコンパイル結果が違うときは、下の compileJava --info や build --info の詳細ログで使用JDK等を調べ、Java Build PathやGradleの依存一覧と照合します。

.\gradlew.bat --version
.\gradlew.bat -q javaToolchains
.\gradlew.bat :app:compileJava --info --rerun-tasks

./gradlew --version
./gradlew -q javaToolchains
./gradlew :app:compileJava --info --rerun-tasks

.\gradlew.bat help --stacktrace

./gradlew help --stacktrace

.\gradlew.bat dependencies --configuration compileClasspath
.\gradlew.bat dependencyInsight --dependency commons-lang3 --configuration runtimeClasspath

./gradlew dependencies --configuration compileClasspath
./gradlew dependencyInsight --dependency commons-lang3 --configuration runtimeClasspath

.\gradlew.bat compileJava --info
.\gradlew.bat dependencies --configuration compileClasspath

./gradlew compileJava --info
./gradlew dependencies --configuration compileClasspath

.\gradlew.bat test --tests "guide.GreetingTest" --rerun-tasks

./gradlew test --tests "guide.GreetingTest" --rerun-tasks

.\gradlew.bat projects
.\gradlew.bat tasks --all

./gradlew projects
./gradlew tasks --all

.\gradlew.bat --version
.\gradlew.bat dependencies --configuration compileClasspath
.\gradlew.bat build --info

./gradlew --version
./gradlew dependencies --configuration compileClasspath
./gradlew build --info

01今回やりたいこと

第1章からの操作を、手順の全文を写さずに再現します。小文字を整えて挨拶するアプリを完成させましょう。

02今、何が足りない？

これまでは案内に沿って進めました。今度は必要な設定と変更箇所を自分で選び、結果から成功を判定します。

03どこを変更する？

既存のSampleAppとSampleSystemは残します。新しい空の練習用親フォルダーに、再び SampleApp を作ります。同名が競合しないよう、Eclipseは File → Switch Workspace → Other… で演習用の別ワークスペースを使います。開いている編集は先に保存してください。

04Eclipseで操作する

1. 最小構成を生成し、Wrapperと基本Taskを確認。
2. Eclipseへ同じフォルダーをImport。
3. java Plugin・Toolchain 11・Greeting.javaを追加し、compileJavaを成功させる。
4. applicationへ置換し、mainClassを指定してrun。
5. version、取得先、Commons Lang依存を追加。Javaで名前の先頭を大文字にする。
6. JUnitとテストを追加。期待値を一度変えて失敗を調べ、正しい期待値に戻す。
7. 第9章の方法でコンパイル・test・runがJDK 11を使うログと、classのmajor version 55を確認。Gradle本体はJDK 25のまま。

plugins {
    application
}

application {
    mainClass = "guide.Greeting"
}

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

version = "1.0"

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.apache.commons:commons-lang3:3.20.0")
    testImplementation(platform("org.junit:junit-bom:5.13.4"))
    testImplementation("org.junit.jupiter:junit-jupiter")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

tasks.test {
    useJUnitPlatform()
}

plugins {
    id 'application'
}

application {
    mainClass = 'guide.Greeting'
}

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

version = '1.0'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.apache.commons:commons-lang3:3.20.0'
    testImplementation platform('org.junit:junit-bom:5.13.4')
    testImplementation 'org.junit.jupiter:junit-jupiter'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

tasks.named('test') {
    useJUnitPlatform()
}

package guide;

import org.apache.commons.lang3.StringUtils;

public class Greeting {
    public static String message(String name) {
        return "Hello, " + StringUtils.capitalize(name) + "!";
    }

    public static void main(String[] args) {
        System.out.println(message("gradle"));
    }
}

package guide;

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

class GreetingTest {
    @Test
    void greetsWithCapital() {
        assertEquals("Hello, Gradle!", Greeting.message("gradle"));
    }
}

.\gradlew.bat test --rerun-tasks
.\gradlew.bat build
.\gradlew.bat run

./gradlew test --rerun-tasks
./gradlew build
./gradlew run

05何が変わった？