IntelliJ IDEA 2024.1 ヘルプ

Gradle 依存関係

IntelliJ IDEA を使用すると、Gradle プロジェクトの依存関係を追加および管理できます。依存関係を追加して、ダイアグラムに表示できます。

Gradle 依存関係を生成する

プロジェクトに追加された依存関係は、Gradle によって管理されます。依存関係を追加または管理する最良の方法は、build.gradle ファイルを使用することです。IntelliJ IDEA モジュール設定内で手動で設定した依存関係は、次の Gradle プロジェクトの再ロード時に破棄されます。

Gradle 依存関係を追加する

  1. エディターで build.gradle ファイルを開きます。

  2. Alt+Insert を押して、生成コンテキストメニューを開きます。

  3. コンテキストメニューから Maven アーティファクト依存関係を追加を選択します。

    Add dependency

    Maven アーティファクト検索ウィンドウが開きます。

  4. Maven アーティファクト検索ウィンドウの検索フィールドに、依存関係の名前の入力を開始します。結果のリストから必要なものを選択し、追加をクリックします。

    Search Artifact
  5. プロジェクトを再ロードします。

    IntelliJ IDEA は、build.gradle ファイルに依存関係を追加します。

    Build script: added dependency

    IntelliJ IDEA は、Gradle ツールウィンドウの依存関係ノードとプロジェクトツールウィンドウの外部ライブラリにも依存関係を追加します。

    Gradle tool window and Project tool window

    追加された依存関係に独自の推移的な依存関係がある場合、IntelliJ IDEA はそれらを両方のツールウィンドウに表示します。推移的な依存関係に加えて、IntelliJ IDEA は Gradle ツールウィンドウで循環依存関係も示します。

    Gradle tool window: cyclic dependencies

    ソースセットの依存関係設定を追加すると、Gradle ツールウィンドウにも表示されます。

    Source set dependency

依存関係をダイアグラムとして表示する

ダイアグラム形式で Gradle 依存関係を処理できます。大規模なプロジェクトがあり、依存関係(推移的なものを含む)がプロジェクト内でどのように接続されているかの全体像を確認したい場合に役立ちます。

  1. Gradle ツールウィンドウでプロジェクトを選択し、ツールバーで the Show Dependencies icon をクリックするか、コンテキストメニューから依存関係の表示オプションを選択します。

    the Show Dependencies option

    依存関係ポップアップを表示Ctrl+Alt+U)オプションを選択して、別のウィンドウでグラフを開くことができます。ポップアップを閉じるには、Escape を押します。

  2. ダイアグラムウィンドウで、IntelliJ IDEA は、推移的なものを含むすべてのプロジェクトの依存関係を表示します。

    Gradle dependencies diagram

    グラフ内の依存関係に移動すると、IntelliJ IDEA はそのバージョン、グループ、アーティファクト ID を表示します。

    Show dependency information

ダイアグラムを管理するには、ダイアグラムウィンドウのツールバーを使用します。ダイアグラムのサイズを変更したり、ファイルにエクスポートしたり、目的のダイアグラムの一部のみを表示したりすることができます。

可視性レベルを変更する

可視性レベルを変更したり、特定のスコープを持つ依存関係を表示したり(コンパイル、テストなど)できます。

  1. ダイアグラムウィンドウで、プロジェクトを選択し、the Change Visibility Level icon をクリックします。

  2. リストから、表示したい依存関係の範囲を選択します。IntelliJ IDEA は、指定された依存範囲のみを表示します。

    Changing visibility level

選択からルートへのパスを表示

依存関係を選択して、それらがどのようにルートに接続されているかを確認できます。

  1. ダイアグラムウィンドウで、プロジェクトへの接続を表示する依存関係を選択します。一度に複数の依存関係を選択する場合は、Shift を押しながら選択します。

  2. ツールバーで the Show Path Root Selection icon をクリックします。

Show Paths Root Selection

選択したノードの近隣を表示

依存関係を選択して、選択したノードに接続されている他の依存関係を確認できます。大きなダイアグラムがあり、その一部だけに注目したい場合に役立ちます。

  1. ダイアグラムウィンドウで、必要な依存関係を選択します。一度に複数の依存関係を選択したい場合は、Shift を押しながら選択してください。

  2. ツールバーで the Show Neighbors of Selected Nodes をクリックします。

Show Neighbors of Selected Nodes

グラフで特定の依存関係を検索する

  1. ダイアグラムウィンドウで、Ctrl+F を押してダイアグラムの要素ポップアップを開きます。

    Search for dependency
  2. 検索する依存関係の名前の入力を開始し、検索結果のリストから必要な依存関係を選択して、Enter を押します。IntelliJ IDEA は、必要な依存関係をグラフで見つけます。

    Found dependency

ダイアグラム構造を表示する

  1. ダイアグラムを生成します。

  2. 左側のツールバーの構造をクリックします。IntelliJ IDEA は、構造ツールウィンドウを開きます。このウィンドウには、選択したブロックとその隣接ブロックの小さなプレビューを含むダイアグラムのマップが表示されます。

    the Structure view

    コンテキストメニューを使用して、ズームインとズームアウト、キャンバスの移動、レイアウトの変更、ダイアグラムの一部のイメージへのエクスポートを行います。

    the context menu

依存関係アナライザー

Gradle 依存関係アナライザーを使用すると、解決済みの依存関係、未解決の依存関係、競合のある依存関係、プロジェクトとサブプロジェクトの推移的な依存関係をすばやく確認して分析できます。

依存関係の解析

  1. Gradle ツールウィンドウのツールバーで、the Analyze Dependencies をクリックします。

    または、Gradle ツールウィンドウで、必要な依存関係を右クリックし、コンテキストメニューから依存関係の解析を選択します。プロジェクトビューでモジュールを右クリックして、同じアクションを使用することもできます。

    Resolved dependencies
  2. 依存関係アナライザーウィンドウでは、分析範囲を絞り込んだり、競合する依存関係のみを確認したり、使用状況を確認したりできます。

    build.gradle ファイル内の必要な依存関係を確認する場合は、使用箇所部分の依存関係を右クリックし、Gradle 依存関係に移動を選択します。プロジェクトノードで Gradle 構成を開くをクリックすると、IntelliJ IDEA によって build.gradle ファイルが開きます。

    パッケージ検索に移動をクリックして、依存関係ツールウィンドウを操作する内の該当の依存関係に移動することもできます。

    重複する依存関係が見つかった場合は、グレー表示されます。

    依存関係アナライザーウィンドウで使用可能なオプションとアイコンの詳細については、リファレンスセクションを参照してください。

依存関係アナライザーツールウィンドウリファレンス

項目

説明

スコープ

プロジェクトですべての依存関係が使用されているスコープを確認できます。スコープ(英語)に基づいて依存関係のリストを絞り込むには、スコープのリストから適切なオプションを選択します。

Dependency analyzer: dependency scope

競合のみを表示

the Conflicts icon をクリックして、未解決または競合する依存関係のみを表示します。

Dependencies with conflicts

グループ ID の表示

Show GroupId をクリックし、グループ ID の表示を選択して、依存関係のリストにグループ ID(英語) を表示します。

ツリー表示

Show as Tree を切り替えて、依存関係のリストをノードの形式またはフラットリストで表示します。

ツリービューは、推移的な依存関係をすばやく確認できます。

展開 / 折りたたみ

the Expand All icon / the Collapse All icon を使用して、依存関係のリストを展開または折りたたみます。

関連ページ:

モジュール

IntelliJ IDEA では、モジュールはプロジェクトの重要な部分であり、プロジェクトと一緒に自動的に作成されます。プロジェクトには複数のモジュールを含めることができます。新しいモジュールを追加し、グループ化し、現時点では必要のないモジュールをアンロードできます。通常、モジュールは 1 つまたは複数のコンテンツルートとモジュールファイルで構成されますが、モジュールはコンテンツルートがなくても存在できます。コンテンツルートは、コードを保存するフォルダーです。通常、ソースコード、単体テスト、リソ...

Gradle プロジェクト

IntelliJ IDEA では、Gradle プロジェクトを管理できます。リンク、プロジェクトの無視、プロファイルの操作、Gradle プロジェクトと IntelliJ IDEA プロジェクトの変更の同期を行うことができます。Gradle コンポジットビルド、Gradle ソースセット、ビルドおよび実行アクションを構成することもできます。build.gradle ファイルに移動する:Gradle ツールウィンドウで、リンクされたプロジェクトを右クリックします。コンテキストメニューから Gradle...

ダイアグラムのツールバーとコンテキストメニュー

ダイアグラムエディターのツールバーを使用してアクションにすばやくアクセスし、コンテキストメニューを使用して表示されたダイアグラムを管理します。ツールバー:(データベースを操作する場合に使用できます。) このボタンをクリックすると、ダイアグラムに主キー列が表示されます。(データベースを操作するときに使用できます。) 次の表示を切り替えます。データベースオブジェクトの視覚化の場合: ダイアグラムの主キー列以外の列を表示または非表示にします。クエリマップの場合: クエリ属性を表示または非表示にする...

パッケージ検索

パッケージ検索を使用すると、IDE 内で依存関係を検索、評価、管理できます。Maven、Gradle、sbt などの主要なビルドツールでサポートされています。依存関係ツールウィンドウを使用して、依存関係を操作できます。パッケージ検索を呼び出すプロジェクトのビルドツールに応じて、エディターで適切なビルドスクリプトを開きます。を押し、開いたリストで依存関係の追加を選択します。依存関係ツールウィンドウで、必要な依存関係を検索し、検索結果のリストでそれを選択して、追加をクリックします。依存関係ツールウィ...

Gradle でのテスト

Gradle プロジェクトでは、他のプロジェクトと同じ方法でテストを作成および実行できます。IntelliJ IDEA では、テストプロセスのデフォルトのテストランナーを変更したり、テストごとにテストランナーを構成することもできます。テストランナーを構成する Gradle ツールウィンドウで、をクリックして Gradle 設定ページを開きます。テストを使用して実行するリストで、選択した Gradle プロジェクトの次のテストランナーオプションのいずれかを選択します。Gradle: IntelliJ I...