IntelliJ IDEA 2020.2ヘルプ

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 フラグの対応する組み合わせに設定されます。

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

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

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

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

  2. Gradleツールウィンドウで、the Link Gradle Project icon をクリックして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プロジェクトがリンクされている場合は、Add module をクリックして別の名前を選択することができます。

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

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

  2. プロジェクトツールウィンドウで、プロジェクトの名前を右クリックします。

  3. 表示されるリストで、新規 | ファイルを選択します。

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

  5. エディターでbuild.graleファイルを開き、必要な情報を追加して、プロジェクトを再度開きます。次の最小限の情報をプロジェクトのビルドスクリプトファイルに含める必要があります。
    plugins { id 'java' } group 'org.example' version '1.0-SNAPSHOT' repositories { mavenCentral() } sourceSets { main { java { srcDirs = ['src'] } } } dependencies { compile 'junit:junit:4.12' }

    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のドキュメント(英語)を参照してください。

最終更新日: 2020年9月16日

関連ページ:

新規プロジェクトの作成

このセクションでは、すぐに使用できる機能について説明します。フレームワークプラグインを使用している場合は、セクション言語およびフレームワーク固有のガイドラインを参照してください。IntelliJ IDEAを起動してください。ようこそ画面が開いたら、新規プロジェクトの作成をクリックします。それ以外の場...

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

このチュートリアルでは、IntelliJ IDEAで単純なJava EE Webアプリケーションを開発する方法について説明します。アプリケーションは、を示す単一のJSPページになります。新しいJava エンタープライズプロジェクトを作成し、JSPページを追加し、GlassFishサーバーの場所をIn...

Gradleツールウィンドウ

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

Gradle プロジェクト

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

Gradle 設定

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

パス選択ダイアログ

このダイアログを使用して、さまざまな状況でファイルまたはフォルダーの場所を指定します。たとえば、実行する実行可能ファイル、使用する構成ファイル、テストまたはインスペクション結果をエクスポートするファイルなどを指定します。ダイアログ名と使用可能な機能は、現在実行しているタスクによって異なります(通常、...