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 - 新しいプロジェクトの名前として追加された アーティファクト Id

   • バージョン - 新しいプロジェクトの 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 settings を参照してください。

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

• Gradle JVM: IntelliJ IDEA が Gradle プロジェクトを開くと、 gradle.properties ファイルで org.gradle.java.home に指定されている適切な JVM バージョンがチェックされ、プロジェクトに使用されます。 指定されていない場合は、プロジェクト SDK が使用されます。 または、 Gradle settings を使用して 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 のドキュメント(英語)を参照してください。

新しいプロジェクト用に Gradle デーモンツールチェーンを構成する

1. IDE を開き、 Shift を 2 回押して検索ウィンドウを開きます。

2. レジストリ と入力して レジストリ ツールウィンドウを開き、 gradle.daemon.jvm.criteria.new.project オプションを選択します。

3. 新規 Gradle プロジェクトを作成します。

   IntelliJ IDEA は、プロジェクト JDK 情報を含む gradle ディレクトリ内に gradle-daemon-jvm.properties ファイルを含むプロジェクトを作成します。

4. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | ビルドツール | Gradle を選択します。

5. Gradle セクションでは、JDK を管理し、 Gradle JVM 基準 を使用してプロジェクトに必要な JDK を選択できます。

   

6. バージョン のリストで必要なバージョンを選択し、 詳細設定 セクション内で ベンダー を選択することもできます。

7. OK をクリックして変更を保存します。

既存のプロジェクト用に Gradle デーモンツールチェーンを構成する

1. Gradle プロジェクトを開きます。

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

3. 開いたウィンドウで、 gradle-daemon-jvm.properties ファイルを追加します。

4. エディターで gradle-daemon-jvm.properties を開き、Gradle JVM バージョンとベンダーを追加します。

   次の例を確認してください。

   toolchainVendor=ibm toolchainVersion=19

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

6. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | ビルドツール | Gradle を選択します。

7. Gradle セクションでは、JDK を管理し、 Gradle JVM 基準 を使用してプロジェクトに必要な JDK を選択できます。

   

8. バージョン のリストで必要なバージョンを選択し、 詳細設定 セクション内で ベンダー を選択することもできます。

9. OK をクリックして変更を保存します。