IntelliJ IDEA 2026.2 Help

Gradle 入門

このチュートリアルでは、IntelliJ IDEA で Gradle ベースのプロジェクトを作成および管理する方法を学びます。 Gradle アプリケーションの作成・実行・テスト、および Gradle を使った実行可能 JAR ファイルの作成と実行方法を学びます。

このチュートリアルで使用するプロジェクトは GitHub で見つけることができます。 このチュートリアルでは Java 25 の構文を使用します。

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

これから Gradle ビルドシステムを使用して、アプリケーションの元になる新しい Java プロジェクトを作成します。

新しい Gradle プロジェクトを作成します。

  1. IntelliJ IDEA を起動してください。

    'ようこそ' 画面が開いたら、「新規プロジェクト 」をクリックします。

    それ以外の場合は、メインメニューの ファイル | 新規プロジェクト に移動します。

  2. 新規プロジェクト ウィザードで、 新規プロジェクト リストから Java を選択します。

  3. プロジェクトに名前を付け(たとえば、 FizzBuzz )、必要に応じてデフォルトの場所を変更します。

  4. Gradleビルドシステム として選択してください。

  5. JDK リストから、利用可能な最新の Oracle OpenJDK バージョンを選択します。

    JDK がコンピューターにインストールされているが、IDE で定義されていない場合は、 JDK を追加 を選択し、JDK ホームディレクトリへのパスを指定します。

    必要な JDK がコンピューターにインストールされていない場合は、 JDK のダウンロード を選択してください。

  6. Gradle DSL として Kotlin を選択し、 サンプルコードの追加 オプションを無効のままにします。

  7. 詳細設定 ノードを開きます。 Gradle バージョン のオプションで 自動選択 を選択します。

  8. アーティファクト ID フィールドと グループ ID フィールドにはデフォルト値を残します。 作成 をクリックします。

新規 Gradle プロジェクト

その後、IntelliJ IDEA が新しい Gradle ベースのプロジェクトを作成・読み込みます。 その構成要素をさらに詳しく見てみましょう。

  • IntelliJ IDEA は次のコードを含む build.gradle.kts ファイルを作成します。

    plugins { id("java") } group = "org.example" version = "1.0-SNAPSHOT" repositories { mavenCentral() } dependencies { testImplementation(platform("org.junit:junit-bom:6.0.0")) testImplementation("org.junit.jupiter:junit-jupiter") testRuntimeOnly("org.junit.platform:junit-platform-launcher") } tasks.test { useJUnitPlatform() }

    IntelliJ IDEA はプロジェクト作成時にテスト依存関係も自動で追加します。

  • IntelliJ IDEA はさらに src ディレクトリと main test サブディレクトリを作成します。 プロジェクト ツールウィンドウ (Alt+1) にそれらが表示されます。

    Gradle プロジェクトビュー
  • リンクされたプロジェクトと、そのデフォルトタスクを持つ専用の Gradle ツールウィンドウ表示 | ツールウィンドウ | Gradle )が利用可能になります。 このツールウィンドウを使ってチュートリアルのタスクを実行します。

    Gradle ツールウィンドウ
  • プロジェクト内の Gradle 設定 には、リンク済みプロジェクト、Gradle JVM、ビルドアクションの情報が保存されます。 Gradle ツールウィンドウで、ツールバーの ビルドツール設定 をクリックすることで、すばやくアクセスできます。

    Gradle 設定

    ビルドとテストのアクションは Gradle に委譲されます。 また、Gradle の ラッパーによってプロジェクトが特定の Gradle バージョンを使用することが保証されます。

  • プロジェクト構造Ctrl+Alt+Shift+S )には、プロジェクトの SDK や、使用されている言語レベルが記載されています。

    プロジェクト構造

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

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

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

  1. プロジェクト ツールウィンドウ(Alt+1 )で、 src/main/java ディレクトリを選択します。

  2. ツールウィンドウのツールバーで 新規ファイルまたはディレクトリ をクリックするか Alt+Insert を押し、 パッケージ を選択します。

  3. 新規パッケージ ダイアログで、パッケージ名を org.gradle.tutorial として、 Enter を押します。

  4. プロジェクト ツールウィンドウで作成したパッケージを右クリックし、 新規 | Java クラス を選択します。

  5. Java クラスの名前(例: FizzBuzzProcessor )を指定し、 Enter を押します。

  6. 次のコードをメイン FizzBuzzProcessor.java クラスに追加します。

    package org.gradle.tutorial; public class FizzBuzzProcessor { private FizzBuzzProcessor() { } 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.java クラスを開き、クラス名にキャレットを置いたら 移動 | テストCtrl+Shift+T )へ移動します。 新規テストの作成 をクリックします。

  2. テストの作成 ダイアログで、 テストライブラリ として JUnit6 を選択し、 パッケージ作成先 として org.gradle.tutorial が選択されていることを確認します。

    クラス名 フィールドにテストクラス名(例: FizzBuzzTest )を指定し、残りのデフォルトオプションはそのままにします。 OK をクリックします。

    作成テストダイアログ
  3. 作成したテストクラスをエディターで開き、次のコードを追加します。

    package org.gradle.tutorial; import org.junit.jupiter.api.Assertions; import org.junit.jupiter.api.Test; public class FizzBuzzTest { @Test public void FizzBuzzNormalNumbers() { Assertions.assertEquals ("1", FizzBuzzProcessor.convert(1)); Assertions.assertEquals ("2", FizzBuzzProcessor.convert(2)); } @Test public void FizzBuzzThreeNumbers() { Assertions.assertEquals ("Fizz", FizzBuzzProcessor.convert(3)); } @Test public void FizzBuzzFiveNumbers() { Assertions.assertEquals ("Buzz", FizzBuzzProcessor.convert(5)); } @Test public void FizzBuzzThreeAndFiveNumbers() { Assertions.assertEquals ("FizzBuzz", FizzBuzzProcessor.convert(15)); } }

ステップ 2. Gradle でアプリケーションを実行する

アプリケーションを実行して、動作を確認しましょう。

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

  1. エディターで FizzBuzzProcessor.java クラスを開きます。 クラスの定義横にある ガターアイコンをクリックして、 実行 'FizzBuzzProcessor.main()' を選択し、アプリケーションを実行します。

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

    実行ツールウィンドウ

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

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

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

  • エディターで FizzBuzzTest.java テストクラスを開きます。 クラス定義横の テストの実行 ガターアイコンをクリックして、 「FizzBuzzTest」を実行 を選択します。

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

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

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

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

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

実行 ツールウィンドウには、エラー発生箇所を含む失敗したテストの情報が表示されます。

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

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

  1. プロジェクト ツールウィンドウで build.gradle.kts ファイルを見つけて、エディターで開きます。

  2. ファイル末尾に、別要素として下記コードを追加してください。

    tasks.jar { manifest { attributes["Main-Class"] = "org.gradle.tutorial.FizzBuzzProcessor" } from({ configurations.runtimeClasspath.get().map { if (it.isDirectory) it else zipTree(it) } }) }
  3. エディターで Gradle の変更を同期 をクリックして、プロジェクトの変更を同期します。

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

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

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

    プロジェクトツールウィンドウ: ビルドディレクトリ
  5. 実行 ツールウィンドウで、結果を確認します。

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

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

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

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

なんでも実行 ポップアップで JAR ファイルを実行できるように、 build.gradle.kts ファイルを少し調整しましょう。

JAR ファイルを実行する

  1. プロジェクト ツールウィンドウで build.gradle.kts ファイルを見つけて、エディターで開きます。

  2. ファイル冒頭のコードを次のように変更してください。

    plugins { id ("java") id ("application") } application { mainClass.set("org.gradle.tutorial.FizzBuzzProcessor") }

    すべての変更を含めた最終版 build.gradle.kts ファイルは GitHub で公開されています。

  3. エディターで Gradle の変更を同期 をクリックして、プロジェクトの変更を同期します。

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

    IntelliJ IDEA は ビルド ディレクトリに追加のサブディレクトリを作成します。

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

  6. 開いた なんでも実行 ポップアップで gradlew :run コマンドを見つけてダブルクリックします。

    なんでも実行: Gradlew Run
  7. 実行 ツールウィンドウで結果を確認してください。 IntelliJ IDEA エディターでアプリケーションを実行したときと同じ結果になるはずです。

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

要約

このチュートリアルでは、次の内容を学習しました。

次のステップ

これらのチュートリアルから、IntelliJ IDEA で Gradle を使って他のタスクを達成する方法も学べます。

利用可能なチュートリアルの一覧は、 IntelliJ IDEA チュートリアル を参照してください。

2026 年 7 月 14 日