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

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

  2. 開いたダイアログで、Gradleプロジェクトの説明 build.gradleを含むファイルを選択します。OKをクリックします。

  3. 開いたダイアログで、プロジェクトとして開くをクリックします。IntelliJ IDEAが開き、IDEでプロジェクトが同期されます。

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

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モジュールを追加することができます。

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

最終更新日: 2019年12月24日