IntelliJ IDEA 2020.1ヘルプ

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プロジェクトを開く

  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設定にアクセスする

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年5月25日

関連ページ:

新規プロジェクトの作成

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

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の期待される設定と一致しないコンパイラ...