Gradle

新規 Gradle プロジェクトを作成する

1. 新規プロジェクトウィザードを起動します。現在 IntelliJ IDEA でプロジェクトが開かれていない場合は、ウェルカム画面で新規プロジェクトをクリックします。それ以外の場合は、メインメニューからファイル | 新規 | プロジェクトを選択します。

2. 新しいプロジェクトに名前を付け、必要に応じてその場所を変更します。

3. Git リポジトリの作成を選択して、新しいプロジェクトをバージョン管理下に置きます。

   後でいつでもそれを行うことができます。

4. プロジェクトで使用する言語を選択します。プラグインを介して利用可能な他の言語を追加する場合は、 をクリックします。

5. ビルドシステムのリストから Gradle を選択します。

6. プロジェクトの SDK(JDK) を指定するか、デフォルトの SDK を使用します。

7. サンプルコードの追加オプションを選択すると、基本的なコードサンプルを含むファイルが作成されます。

8. Gradle DSL を選択します。従来の構文には Groovy を選択でき、代わりに Kotlin を選択できます。

9. 詳細設定で、Maven の座標(英語)に類似するフィールドを指定します。これらの設定は、プロジェクトを Maven リポジトリにデプロイする場合に役立つことがあります。指定したフィールド(英語)が build.gradle ファイルに追加されます。

   • Gradle ディストリビューション : デフォルトの優先オプションである Gradle ラッパー(英語)を選択するか、特定のローカル Gradle バージョンを使用する場合はローカルインストールを選択します。

   • Gradle バージョン : ラッパーオプションが選択されている場合、自動選択オプションの選択を解除してドロップダウンリストから特定のバージョンを選択しない限り、最新の Gradle ディストリビューションが使用されます。

     または、ローカルインストールを選択した場合は、ローカルで定義したバージョンが使用されます。

   • 自動選択 : プロジェクトで使用する Gradle バージョンを指定するには、このオプションの選択を解除します。

   • 将来のプロジェクトのためにこれらの設定を使用 : 将来のプロジェクトで構成された Gradle バージョンを使用するには、このチェックボックスを選択します。

   • グループ ID - 新しいプロジェクトの groupId プロジェクトをローカルにデプロイする予定の場合は、このフィールドを省略することができます。

   • アーティファクト ID - 新しいプロジェクトの名前として追加された artifactId

   • バージョン - 新しいプロジェクトの version デフォルトでは、このフィールドは自動的に指定されます。

10. 作成をクリックします。

ビルドツールとして Gradle を使用して Jakarta EE プロジェクトを作成する

1. 新規プロジェクトウィザードを起動します。現在 IntelliJ IDEA でプロジェクトが開かれていない場合は、ウェルカム画面で新規プロジェクトをクリックします。それ以外の場合は、メインメニューからファイル | 新規 | プロジェクトを選択します。

2. ジェネレーターセクションで、Jakarta EE を選択します。

3. プロジェクトの名前、場所、言語などの適切なオプションを選択してプロジェクトを構成し、ビルドツールとして Gradle を選択します。

4. 作成をクリックします。

   IntelliJ IDEA は、専用の Gradle ツールウィンドウで Gradle プロジェクトを作成し、必要な依存関係を追加します。

   詳細については、チュートリアル: 最初の Jakarta EE アプリケーションを参照してください。

既存の Gradle プロジェクトを開く

1. 現在 IntelliJ IDEA でプロジェクトを開いていない場合は、ウェルカム画面でオープンをクリックします。それ以外の場合は、メインメニューからファイル | オープンを選択します。

   IntelliJ IDEA モデルからプロジェクトをインポートする必要があるカスタムプラグインがある場合は、Ctrl+Shift+A を押して既存ソースからプロジェクトアクションを検索します。

2. 開いたダイアログで、Gradle プロジェクトを含むディレクトリを選択し、OK をクリックします。

   IntelliJ IDEA が開き、IDE でプロジェクトが同期されます。

Gradle 設定オプションを調整する必要がある場合は、Gradle 設定を参照してください。

Gradle JVM と言語レベルを確認する

• Gradle JVM : IntelliJ IDEA が Gradle プロジェクトを開くと、gradle.properties ファイルで org.gradle.java.home に指定されている適切な JVM バージョンがチェックされ、プロジェクトに使用されます。指定されていない場合は、プロジェクト SDK が使用されます。または、Gradle 設定を使用して Gradle JVM を構成することもできます。

• 言語レベル : 言語レベルの設定は、ソースルートまたはモジュールに適用されます。Gradle プロジェクトにリンクされたプロジェクトが 1 つある場合、プロジェクトのデフォルト言語レベルは、モジュールの言語レベルの中で最小の言語レベルに設定されます。モジュールの言語レベルは、build.gradle ファイルで sourceCompatibility に設定されています。

  プレビューパーツは、モジュールソースセットのプレビューフラグの組み合わせに設定されます。ソースセットモジュールの言語レベルは、sourceCompatibility プロパティと --enable-preview フラグの対応する組み合わせに設定されます。

Gradle プロジェクトを IntelliJ IDEA プロジェクトにリンクする

1 つの IntelliJ IDEA プロジェクト内に複数の Gradle プロジェクトを含めることができます。コードの一部を別のプロジェクトに保持する場合、作業が必要なレガシープロジェクトがある場合、Gradle コンポジットビルドがある場合、マイクロサービス(英語)で作業する場合に役立つことがあります。このようなプロジェクトを IntelliJ IDEA でリンクし、同時に管理することができます。

Gradle プロジェクトを開くと、プロジェクトのリンクが自動的に確立され、Gradle ツールウィンドウが有効になります。

IntelliJ IDEA プロジェクトが Gradle プロジェクトにリンクされていない場合、Gradle ツールウィンドウは無効になります。この場合、IntelliJ IDEA は、すぐに Gradle プロジェクトを再インポートして Gradle ツールウィンドウを有効にするリンクを含むメッセージを表示します。Gradle ツールウィンドウがアクティブな場合、少なくとも 1 つの Gradle プロジェクトがリンクされています。

1. Gradle ツールウィンドウを開きます。

2. Gradle ツールウィンドウで、 をクリックして Gradle プロジェクトをアタッチします。

3. 開いたダイアログで、目的の build.gradle ファイルを選択し、OK をクリックします。

4. Gradle からモジュールをインポートウィンドウで、リンクしようとしている Gradle プロジェクトのオプションを指定し、OK をクリックします。

   プロジェクトはリンクされています。Gradle ツールウィンドウには、ツールバーと Gradle エンティティのツリービューが表示されます。

プロジェクトツールウィンドウで、以前にリンク解除されたプロジェクトをリンクバックする必要がある場合、または追加された build.gradle モジュールを右クリックするか、Gradle Kotlin モジュールの場合は build.gradle.kts ファイルを選択し、Gradle プロジェクトのインポートを選択します。

新しい Gradle モジュールを既存の Gradle プロジェクトに追加する

すでに作業しているプロジェクトに Gradle モジュールを追加することができます。

1. メインメニューでファイル | 新規 | モジュールに移動し、新規モジュールウィザードを開きます。

2. 既存のプロジェクトが Gradle プロジェクトではない場合、モジュールを追加するプロセスは新しい Gradle プロジェクトの作成と同じです。既存のプロジェクトが Gradle プロジェクトの場合、新しいモジュールを追加するプロセスはより短くなります。アーティファクト ID フィールドにモジュールの名前を指定する必要があります。残りの情報は自動的に追加され、デフォルト設定を使用することも、好みに応じて変更することもできます。また、次へモジュールとして追加フィールドには、デフォルトで、モジュールを追加しようとしているプロジェクトの名前が表示されることに注意してください。他のリンクされた Gradle プロジェクトがある場合は、 をクリックして別の名前を選択できます。

通常のプロジェクトを Gradle プロジェクトに変換する

1. IntelliJ IDEA でプロジェクトを開きます。

2. プロジェクトツールウィンドウで、プロジェクトの名前を右クリックし、新規 | ファイルを選択します。

3. 開いたダイアログで build.gradle と入力し、OK をクリックします。

4. エディターで build.gradle ファイルを開き、必要な情報を追加して、プロジェクトを再度開きます。プロジェクトのビルドスクリプトファイルには、次の最小限の情報を含める必要があります。

   plugins { id 'java' } group 'org.example' version '1.0-SNAPSHOT' repositories { mavenCentral() } sourceSets { main { java { srcDirs = ['src'] } } } dependencies { testImplementation platform('org.junit:junit-bom:5.10.0') testImplementation 'org.junit.jupiter:junit-jupiter' } test { useJUnitPlatform() }

   build.gradle ファイルを作成するとすぐに、IntelliJ IDEA は Gradle ビルドスクリプトを認識し、プロジェクトを Gradle としてロードすることを提案する通知を表示します。プロジェクトをロードした後、IntelliJ IDEA は Gradle ツールウィンドウを有効にします。

   また、settings.gradle ファイルをプロジェクトに追加して rootProject.name = 'projectName' を追加することをお勧めします。ここで、'projectName' はプロジェクトの名前になります。

Gradle 設定にアクセスする

Gradle 設定を使用して、リンクされた各 Gradle プロジェクト、Gradle バージョン、プロジェクトの変更のインポートなどのビルドおよび実行アクションを構成します。

1. 設定ダイアログ（Ctrl+Alt+S）で、ビルド、実行、デプロイ | Gradle に移動します。

   

2. Gradle 設定ページで、利用可能なオプションを設定し、OK をクリックして変更を保存します。

プロジェクトの Gradle バージョンを構成する

IntelliJ IDEA では、さまざまなオプションを使用して Gradle プロジェクト用に Gradle バージョンを構成できます。デフォルトの Gradle ラッパーを使用するか、タスクとして Gradle ラッパーを使用するか、ローカル Gradle ディストリビューションを構成することができます。

1. Gradle ツールウィンドウで を選択すると、Gradle 設定ページにすばやくアクセスできます。

   

2. 分布リストで、以下のいずれかのオプションを選択します。

   • ラッパー : これは、Gradle ラッパー(英語)を使用する推奨デフォルトオプションです。

     この場合は、Gradle バージョンの更新を Gradle に委譲して、ビルド用の自動 Gradle ダウンロードを入手します。このオプションはまた正確な Gradle バージョンで構築することを可能にします。Gradle バージョンは、プロジェクトの gradle ディレクトリの gradle-wrapper.properties ファイルに保存され、Gradle バージョンの問題を解消できます。

   • ラッパータスク : wrapper タスク構成に従って Gradle ラッパーを構成するには、このオプションを選択します。プロジェクトで使用する Gradle のバージョンを制御したい場合は便利かもしれません。

     デフォルトの Gradle ラッパーオプションを使用してから Gradle wrapper タスク設定に切り替えた場合、タスクで行った変更はプロジェクトのインポート中に自動的に更新されます。

   • ローカルインストール : 手動でダウンロードして特定の Gradle バージョンを使用する場合は、このオプションを選択してください。指定した Gradle プロジェクトをインポートするとき、およびそのタスクを実行するときに、IntelliJ IDEA が Gradle を実行する Gradle インストールおよび JVM の場所を指定します。

   変更を保存するには、OK をクリックします。

Gradle プロジェクトの VM オプションを追加する

gradle.properties ファイルを使用して、Gradle プロジェクトの VM オプションを指定できます。

1. Gradle プロジェクトを作成または開きます。

2. プロジェクトツールウィンドウでプロジェクトを右クリックし、コンテキストメニューから新規 | ファイルを選択します。

3. 新規ファイルダイアログで、ファイル名として gradle.properties を入力し、OK をクリックします。

4. 作成したファイルをエディターで開き、必要な VM オプションを追加します。

   

詳細については、Gradle のドキュメント(英語)を参照してください。

デーモンのヒープサイズを増やす

gradle.properties ファイルを使用して、プロジェクトの既存の Gradle デーモンヒープサイズを調整できます。

1. Gradle プロジェクトを作成または開きます。

2. プロジェクトツールウィンドウでプロジェクトを右クリックし、コンテキストメニューから新規 | ファイルを選択します。

3. 新規ファイルダイアログで、ファイル名として gradle.properties を入力し、OK をクリックします。

4. 作成したファイルをエディターで開き、org.gradle.jvmargs=(JVM arguments) プロパティを使用して必要なデーモンサイズを指定します。

   デフォルトのサイズは -Xmx512m "-XX:MaxMetaspaceSize=256m" です。

   構文例として、次のコードスニペットを確認してください。

   org.gradle.jvmargs=-Xmx4096m

詳細については、Gradle のドキュメント(英語)を参照してください。