Gradle 入門
このチュートリアルでは、Gradle プロジェクトを作成して実行およびテストし、Gradle を使用して実行可能 JAR ファイルを実行します。
このチュートリアルで使用されているプロジェクトは、 GitHub(英語) にあります。 パッケージ名が com.gradle.tutorial から org.mytest に変更されていることに注意してください。 また、Gradle、JDK、JUnit のバージョンも異なります。
ステップ 1. プロジェクトの作成
Java で Gradle プロジェクトを作成しましょう。
IntelliJ IDEA を使用して新しい Gradle プロジェクトを作成する。
'ようこそ' 画面で、 新規プロジェクト をクリックします。

開いたページで、プロジェクトの名前(FizzBuzz)と場所を指定しましょう。
Gradle プロジェクトを作成しているため、プロジェクトと Gradle に必要な Java オプションを選択しましょう。
IntelliJ IDEA は、 JDK フィールドにプロジェクト SDK (JDK) を自動的に追加します。 このチュートリアルでは、オープンな JDK 14 バージョンを使用します。
選択した JDK は変更可能で、IntelliJ IDEA が適切な Gradle バージョンをダウンロードします。 インターネット接続のみが必要です。
Gradle DSL のデフォルトの Groovy をそのままにして、 サンプルコードの追加 オプションの選択を解除します。これは、独自のコードを最初から追加するためです。
基本的にプロジェクトの名前である アーティファクト ID のデフォルト情報を使用し、 グループ ID フィールドにデフォルト情報を残すことができます。
作成 をクリックします。
プロジェクトを作成し、IDE による解析が完了したら、中身を見てみましょう。
IntelliJ IDEA は、次のコードを含む build.gradle ファイルを使用してプロジェクトを作成します。
plugins { id 'java' } group 'org.example' version '1.0-SNAPSHOT' repositories { mavenCentral() } dependencies { testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.0' testImplementation 'org.junit.jupiter:junit-jupiter' } test { useJUnitPlatform() }ご覧のとおり、IntelliJ IDEA はテストの依存関係を便利に追加します。 IntelliJ IDEA は、 build.gradle ファイル内のコード補完をサポートします。 依存関係をさらに追加することにした場合、IntelliJ IDEA はそれらの名前とバージョンをすばやく見つけます。
IntelliJ IDEA は、 src フォルダーを作成し、その中に main サブディレクトリと test サブディレクトリを プロジェクト ツールウィンドウ内に作成します。

IntelliJ IDEA は、関連付けられたプロジェクトおよびデフォルトタスクを持つ専用の Gradle ツールウィンドウを有効化します。 このウィンドウを使用してタスクを実行します。

このウィンドウを閉じた場合でも、メニューから を選択することで、いつでもアクセスできます。
プロジェクト内の Gradle 設定 は、関連付けられたプロジェクト情報、Gradle JVM、ビルドアクションなどを保管するために使用します。 Gradle ツールウィンドウから素早くアクセスでき、ツールバーの
をクリックします。

ご覧のとおり、ビルドアクションとテストアクションは Gradle に委譲されています。 また、Gradle ラッパーを使用して、プロジェクトの Gradle を決定しました。
プロジェクト構造 (Ctrl+Alt+Shift+S )には、プロジェクトで利用する JDK の情報と言語レベルが含まれています。

ステップ 1. Java コードを追加する
次に、最初の 100 個の FizzBuzz(英語) 番号を出力する Java アプリケーションを作成します。
Gradle プロジェクトに Java クラスを追加する
プロジェクト ツールウィンドウで、 src フォルダーを開きます。
main ディレクトリをクリックしてから、 java サブディレクトリを右クリックし、リストから を選択します。
新規パッケージ ダイアログで、パッケージの名前 com.gradle.tutorial を入力しましょう。
次に、パッケージを右クリックして、 を選択します。
新規 Java クラス ダイアログで、Java クラスの名前を指定し、 OK をクリックします。 私たちの場合、
FizzBuzzProcessorです。
次のコードをメイン
FizzBuzzProcessorクラスに追加します。package org.mytest; public class FizzBuzzProcessor { public static void main(String[] args) { for (int i = 1; i <= 100; i++) { System.out.println(convert(i)); } } public static String convert(int fizzBuzz) { if (fizzBuzz % 15 == 0) { return "FizzBuzz"; } if (fizzBuzz % 3 == 0) { return "Fizz"; } if (fizzBuzz % 5 == 0) { return "Buzz"; } return String.valueOf(fizzBuzz); } }
アプリケーションの準備が整いました。 それでは、それに必要なテストを作成しましょう。
テストクラスを作成する
エディターでメインクラス
FizzBuzzProcessorを開き、クラス名にキャレットを配置して Ctrl+Shift+T を押します。開いたダイアログで、テストライブラリが
JUnit5であり、宛先パッケージがcom.gradle.tutorialであることを確認しましょう。 FizzBuzzTest という名前を追加し、残りのデフォルトオプションをそのままにして、 OK をクリックします。次に、作成したテストクラスを開き、次のコードを追加します。
package org.mytest; import org.junit.jupiter.api.Assertions; import org.junit.jupiter.api.Test; import static org.junit.jupiter.api.Assertions.*; public class FizzBuzzTest { @Test public void FizzBuzzNormalNumbers() { FizzBuzzProcessor fb = new FizzBuzzProcessor(); Assertions.assertEquals("1", fb.convert(1)); Assertions.assertEquals("2", fb.convert(2)); } @Test public void FizzBuzzThreeNumbers() { FizzBuzzProcessor fb = new FizzBuzzProcessor(); Assertions.assertEquals("Fizz", fb.convert(3)); } @Test public void FizzBuzzFiveNumbers() { FizzBuzzProcessor fb = new FizzBuzzProcessor(); Assertions.assertEquals("Buzz", fb.convert(5)); } @Test public void FizzBuzzThreeAndFiveNumbers() { FizzBuzzProcessor fb = new FizzBuzzProcessor(); Assertions.assertEquals("FizzBuzz", fb.convert(15)); } }
ステップ 2. Gradle でアプリケーションを実行する
すぐにアプリケーションを実行して、機能するかどうか確認してみましょう。
エディターからメインクラスを実行する
エディターでメインクラス
FizzBuzzProcessorを開きます。ガターで、
をクリックし、 実行 'FizzBuzzProcessor.main()' を選択します。

実行 ツールウィンドウで結果を確認してください。

ステップ 3. テストの実行
次に、作成したテストを実行してみましょう。
Gradle プロジェクトでテストを実行する
エディターから、または test タスクを使用して Gradle ツールウィンドウからテストを実行できます。 エディターを使用します。
エディターのガターにある
をクリックします。

テストの結果は、 実行 ツールウィンドウに表示されます。

いずれかのテストでデフォルトの数を変更すると、失敗します。

ご覧のように、 実行 ツールウィンドウには、エラーが発生したコードの特定の行を含む、失敗したテストに関する情報が表示されます。
ステップ 4. 実行可能な JAR ファイルを作成する
次に、アプリケーションをビルドして、実行可能な JAR ファイルを作成します。
プロジェクト ツールウィンドウで、 build.gradle ファイルをダブルクリックしてエディターで開きます。
次のコードを追加します。
jar { manifest { attributes "Main-Class": "org.mytest.FizzBuzzProcessor" } from { configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) } } }エディターで
をクリックして、プロジェクトへの変更を同期します。
Gradle ツールウィンドウでプロジェクトのノードを開き、次に タスク ノードを開き、 ビルド タスクをダブルクリックして実行します。

IntelliJ IDEA は、JAR ファイルを含む ビルド ディレクトリを作成します。

作成した JAR ファイルは、
java -jarコマンドを使用してコマンドラインで実行できます。実行 ツールウィンドウで、結果を確認します。

ビルドタスクには、Gradle が実行するテストタスクが含まれていることに注意してください。 テストの 1 つでミスをすると、テストタスクが失敗し、ビルドタスクも失敗します。

ステップ 6. Gradle で JAR ファイルを実行する
次に、 build.gradle ファイルをもう少し調整して、 なんでも実行 ウィンドウで JAR ファイルを実行できるようにします。
JAR ファイルを実行する
プロジェクト ツールウィンドウで、 build.gradle ファイルをダブルクリックしてエディターで開きます。
pluginsセクションと次のコードにid 'application'を追加しましょう:application { mainClassName = 'org.mytest.FizzBuzzProcessor' }エディターで
をクリックして、変更をプロジェクトにロードします。
Gradle ツールウィンドウで、プロジェクトのノードを開き、次に タスク ノードを開きます。 Gradle が ディストリビューション ノードを追加したことがわかります。 ノードを開き、 assembleDist タスクをダブルクリックして実行します。
ここで ビルド ディレクトリを確認すると、IntelliJ IDEA が追加のディレクトリを作成したことがわかります。

Gradle ツールウィンドウで、ツールバーの
をクリックします。
開いたウィンドウで、
gradlew runコマンドを入力します。
IntelliJ IDEA エディターでアプリケーションを実行したときと同じ結果になるはずです。

または、 application ノードで 実行 タスクを実行することもできます。
