IntelliJ IDEA 2026.1 Help

Gradle 入門

このチュートリアルでは、Gradle プロジェクトを作成して実行およびテストし、Gradle を使用して実行可能 JAR ファイルを実行します。

このチュートリアルで使用されているプロジェクトは、 GitHub(英語) にあります。 パッケージ名が com.gradle.tutorial から org.mytest に変更されていることに注意してください。 また、Gradle、JDK、JUnit のバージョンも異なります。

ステップ 1. プロジェクトの作成

Java で Gradle プロジェクトを作成しましょう。

IntelliJ IDEA を使用して新しい Gradle プロジェクトを作成する。

  1. 'ようこそ' 画面で、 新規プロジェクト をクリックします。

    新規プロジェクト Gradle
  2. 開いたページで、プロジェクトの名前(FizzBuzz)と場所を指定しましょう。

  3. Gradle プロジェクトを作成しているため、プロジェクトと Gradle に必要な Java オプションを選択しましょう。

  4. IntelliJ IDEA は、 JDK フィールドにプロジェクト SDK (JDK) を自動的に追加します。 このチュートリアルでは、オープンな JDK 14 バージョンを使用します。

    選択した JDK は変更可能で、IntelliJ IDEA が適切な Gradle バージョンをダウンロードします。 インターネット接続のみが必要です。

    Gradle DSL のデフォルトの Groovy をそのままにして、 サンプルコードの追加 オプションの選択を解除します。これは、独自のコードを最初から追加するためです。

  5. 基本的にプロジェクトの名前である アーティファクト 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 サブディレクトリを プロジェクト ツールウィンドウ内に作成します。

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

    Gradle ツールウィンドウ

    このウィンドウを閉じた場合でも、メニューから 表示 | ツールウィンドウ | Gradle を選択することで、いつでもアクセスできます。

  • プロジェクト内の Gradle 設定 は、関連付けられたプロジェクト情報、Gradle JVM、ビルドアクションなどを保管するために使用します。 Gradle ツールウィンドウから素早くアクセスでき、ツールバーの をクリックします。

    Gradle 設定

    ご覧のとおり、ビルドアクションとテストアクションは Gradle に委譲されています。 また、Gradle ラッパーを使用して、プロジェクトの Gradle を決定しました。

  • プロジェクト構造Ctrl+Alt+Shift+S )には、プロジェクトで利用する JDK の情報と言語レベルが含まれています。

    プロジェクト構造

ステップ 1. Java コードを追加する

次に、最初の 100 個の FizzBuzz(英語) 番号を出力する Java アプリケーションを作成します。

Gradle プロジェクトに Java クラスを追加する

  1. プロジェクト ツールウィンドウで、 src フォルダーを開きます。

  2. main ディレクトリをクリックしてから、 java サブディレクトリを右クリックし、リストから 新規 | パッケージ を選択します。

  3. 新規パッケージ ダイアログで、パッケージの名前 com.gradle.tutorial を入力しましょう。

  4. 次に、パッケージを右クリックして、 新規 | Java クラス を選択します。

  5. 新規 Java クラス ダイアログで、Java クラスの名前を指定し、 OK をクリックします。 私たちの場合、 FizzBuzzProcessor です。

    新規クラスの作成ダイアログ
  6. 次のコードをメイン 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); } }

アプリケーションの準備が整いました。 それでは、それに必要なテストを作成しましょう。

テストクラスを作成する

  1. エディターでメインクラス FizzBuzzProcessor を開き、クラス名にキャレットを配置して Ctrl+Shift+T を押します。

  2. 開いたダイアログで、テストライブラリが JUnit5 であり、宛先パッケージが com.gradle.tutorial であることを確認しましょう。 FizzBuzzTest という名前を追加し、残りのデフォルトオプションをそのままにして、 OK をクリックします。

  3. 次に、作成したテストクラスを開き、次のコードを追加します。

    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 でアプリケーションを実行する

すぐにアプリケーションを実行して、機能するかどうか確認してみましょう。

エディターからメインクラスを実行する

  1. エディターでメインクラス FizzBuzzProcessor を開きます。

  2. ガターで、 をクリックし、 実行 'FizzBuzzProcessor.main()' を選択します。

    Gradle でアプリケーションを実行
  3. 実行 ツールウィンドウで結果を確認してください。

    実行ツールウィンドウ

ステップ 3. テストの実行

次に、作成したテストを実行してみましょう。

Gradle プロジェクトでテストを実行する

エディターから、または test タスクを使用して Gradle ツールウィンドウからテストを実行できます。 エディターを使用します。

  • エディターのガターにある をクリックします。

    Gradle ガターからの実行テスト

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

ツールウィンドウの実行 / テストに合格

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

ツールウィンドウの実行 / テストの失敗

ご覧のように、 実行 ツールウィンドウには、エラーが発生したコードの特定の行を含む、失敗したテストに関する情報が表示されます。

ステップ 4. 実行可能な JAR ファイルを作成する

次に、アプリケーションをビルドして、実行可能な JAR ファイルを作成します。

  1. プロジェクト ツールウィンドウで、 build.gradle ファイルをダブルクリックしてエディターで開きます。

  2. 次のコードを追加します。

    jar { manifest { attributes "Main-Class": "org.mytest.FizzBuzzProcessor" } from { configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) } } }
  3. エディターで をクリックして、プロジェクトへの変更を同期します。

  4. Gradle ツールウィンドウでプロジェクトのノードを開き、次に タスク ノードを開き、 ビルド タスクをダブルクリックして実行します。

    Gradle ツールウィンドウ: ビルドタスク

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

    プロジェクトツールウィンドウ: ビルドディレクトリ

    作成した JAR ファイルは、 java -jar コマンドを使用してコマンドラインで実行できます。

  5. 実行 ツールウィンドウで、結果を確認します。

    実行ツールウィンドウ: ビルドタスク

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

    実行ツールウィンドウ: 失敗したテストでビルド

ステップ 6. Gradle で JAR ファイルを実行する

次に、 build.gradle ファイルをもう少し調整して、 なんでも実行 ウィンドウで JAR ファイルを実行できるようにします。

JAR ファイルを実行する

  1. プロジェクト ツールウィンドウで、 build.gradle ファイルをダブルクリックしてエディターで開きます。

  2. plugins セクションと次のコードに id 'application' を追加しましょう:

    application { mainClassName = 'org.mytest.FizzBuzzProcessor' }
  3. エディターで をクリックして、変更をプロジェクトにロードします。

  4. Gradle ツールウィンドウで、プロジェクトのノードを開き、次に タスク ノードを開きます。 Gradle が ディストリビューション ノードを追加したことがわかります。 ノードを開き、 assembleDist タスクをダブルクリックして実行します。

    ここで ビルド ディレクトリを確認すると、IntelliJ IDEA が追加のディレクトリを作成したことがわかります。

    プロジェクトツールウィンドウ: ビルドディレクトリ
  5. Gradle ツールウィンドウで、ツールバーの なんでも実行 をクリックします。

  6. 開いたウィンドウで、 gradlew run コマンドを入力します。

    なんでも実行: Gradlew Run

    IntelliJ IDEA エディターでアプリケーションを実行したときと同じ結果になるはずです。

    実行ツールウィンドウ: タスク出力を実行する

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

    Gradle ツールウィンドウ: タスクの実行
2026 年 3 月 30 日