IntelliJ IDEA 2020.3 ヘルプ

Gradle

IntelliJ IDEA は、Gradle(英語) との完全に機能的な統合をサポートし、構築プロセスの自動化を支援します。新しい Gradle プロジェクトを簡単に作成し、既存のプロジェクトを開いて同期し、リンクされた複数のプロジェクトを同時に操作して、管理できます。

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

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

  2. 左側のオプションから Gradle を選択します。

  3. プロジェクト SDK と追加のフレームワークまたはライブラリを指定します(IntelliJ IDEA は適切なプラグインを build.gradle ファイルに追加します)。 次へをクリックします。
  4. ウィザードの次のページで、Maven の座標(英語)に似たフィールドを指定します。これらの設定は、プロジェクトを Maven リポジトリにデプロイする場合に役立つことがあります。指定したフィールド(英語)build.gradle ファイルに追加されます。
    • グループ ID - 新しいプロジェクトの groupId プロジェクトをローカルにデプロイする予定の場合は、このフィールドを省略することができます。

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

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

    親 Gradle プロジェクトが指定されている場合、指定されたフィールドは親から継承できます(継承をクリックします)。
    次へをクリックします。
  5. 名前と場所の設定を指定します。完了をクリックします。

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

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

  2. 左側のオプションから Java エンタープライズを選択します。

  3. ビルドツールとして Gradle を選択し、次へをクリックします。

  4. ウィザードの次のページで、プロジェクトの追加のライブラリとフレームワークを選択し、次へをクリックします。

  5. ウィザードの次のページで、プロジェクトの名前、場所、アーティファクトの座標を指定します。完了をクリックします。

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

    詳細については、チュートリアル: 初めての Java 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 モジュールを既存の Gradle プロジェクトに追加する

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

  1. プロジェクトで、メインメニューからファイル | 新規 | 新規モジュールを選択して新規モジュールウィザードを開きます。

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

通常のプロジェクトを 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 { compile 'junit:junit:4.12' }

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

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

Gradle 設定にアクセスする

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

  1. 設定 / 環境設定ダイアログ Ctrl+Alt+S で、ビルド、実行、デプロイ | Gradle に移動します。
    Gradle settings
  2. Gradle 設定ページで、利用可能なオプションを設定し、OK をクリックして変更を保存します。

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

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

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

    Gradle settings

  2. 使用する Gradle リストで、以下のいずれかのオプションを選択します。
    • 'gradle-wrapper.properties' ファイル : これは Gradle ラッパー(英語)を使用する推奨デフォルトオプションです。

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

    • Gradle ビルドスクリプトの 'wrapper' タスク : 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 オプションを追加します。

    the gradle.properties file

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

関連ページ:

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

このセクションでは、すぐに使用できる機能について説明します。フレームワークプラグインを使用している場合は、対応するドキュメントのセクションを参照してください。IntelliJ IDEA を起動してください。ウェルカム画面が開いたら、新規プロジェクトをクリックします。それ以外の場合は、メインメニューか...

チュートリアル: 初めての Java EE アプリケーション

このチュートリアルでは、IntelliJ IDEA で簡単な Java EEWeb アプリケーションを作成する方法について説明します。アプリケーションには、を表示する単一の JSP ページと、も表示する Java サーブレットへのリンクが含まれます。Web アプリケーションテンプレートを使用して新し...

Gradle ツールウィンドウ

Gradle プロジェクトを作成または開くと、Gradle ツールウィンドウが自動的に有効になります。右側のサイドバーのGradleをクリックして、ツールウィンドウを開きます。ツールウィンドウには、Gradle リンクプロジェクト、そのタスク、依存関係、基になるbuild.gradleファイルに加え...

Gradle プロジェクト

IntelliJ IDEA では、Gradleプロジェクトを管理できます。リンク、プロジェクトの無視、プロファイルの操作、Gradle プロジェクトと IntelliJ IDEA プロジェクトの変更の同期を行うことができます。Gradle コンポジットビルド、Gradle ソースセット、ビルドおよび...

Gradle 設定

このページを使用して、作成、オープン、またはリンクされた Gradle プロジェクトの設定を構成します。オフラインモードを設定するには、Gradle ツールウィンドウを参照してください。VM オプションを追加する必要がある場合は、Gradle VM オプションを参照してください。Gradle ユーザ...

Maven の一般的な課題のトラブルシューティング

Maven プロジェクトで課題が発生した場合は、以下の解決策と回避策が課題の解決に役立つかどうかを確認できます。Maven プロジェクトのコンパイラーバージョンの問題を修正する方法 :場合によっては、Maven プロジェクトをインポートするときに IntelliJ IDEA の期待される設定と一致し...