IntelliJ IDEA 2024.3 ヘルプ

ライブラリ

ライブラリは、プロジェクトに追加できるコンパイル済みコードのコレクションです。IntelliJ IDEA では、ライブラリは、グローバル(多くのプロジェクトで使用可能)、プロジェクト(プロジェクト内のすべてのモジュールで使用可能)、およびモジュール(1 つのモジュールで使用可能)の 3 つのレベルで定義できます。

Java ライブラリには、クラスファイル、アーカイブ、クラスファイルを含むディレクトリ、ネイティブライブラリ .dll.so.jnilib を含むディレクトリを含めることができます。

ライブラリを定義する

ライブラリを定義してモジュールの依存関係に追加すると、コードを記述するときに IDE がそのコンテンツを提供します。IntelliJ IDEA は、ライブラリのコードを使用してアプリケーションを構築し、デプロイします。

グローバルライブラリを定義する

  1. メインメニューで、ファイル | プロジェクト構造 Ctrl+Alt+Shift+S に移動します。

  2. プラットフォーム設定で、グローバルライブラリを選択します。

  3. the Add button をクリックして、次のいずれかを選択します。

    Defining a global library

    このダイアログでは、Add 既存のライブラリにクラスを追加Specify Documentation URL 外部ドキュメント URL を指定Exclude ライブラリからアイテムを除外Remove ライブラリを削除することもできます。

グローバルライブラリへの参照は、options | applicationLibraries.xml の IDE 構成ディレクトリに保存されます。

プロジェクトライブラリを定義する

  1. メインメニューで、ファイル | プロジェクト構造 Ctrl+Alt+Shift+S に移動します。

  2. プロジェクト設定で、ライブラリを選択します。

  3. the Add button をクリックして、次のいずれかを選択します。

    Defining a project library
  4. 新しいライブラリを追加するモジュールを選択します。

このダイアログでは、Add 既存のライブラリにクラスを追加Specify Documentation URL 外部ドキュメント URL を指定Exclude ライブラリからアイテムを除外Remove ライブラリを削除することもできます。

プロジェクトライブラリへの参照は、プロジェクトと一緒に libraries.idea フォルダーに保存されます。

ライブラリをモジュールの依存関係に追加する

グローバルライブラリとプロジェクトライブラリは、モジュールの依存関係に追加するまで利用できません。

  1. メインメニューで、ファイル | プロジェクト構造 | プロジェクト設定 | モジュールに移動します。

  2. ライブラリを追加するモジュールを選択し、依存関係をクリックします。

  3. Add ボタンをクリックし、ライブラリを選択します。

    Adding a new module library
  4. 開いたダイアログで、モジュールに追加するプロジェクトまたはグローバルライブラリを選択します。

    または、新規ライブラリをクリックして必要なオプションを選択します。コンピューター上のファイルから Java および Kotlin ライブラリを追加するか、Maven からライブラリをダウンロードできます。

    Adding a new module library

モジュールライブラリへの参照は、モジュール .iml ファイルに保存されます。このファイルはモジュール構成を保持するために使用されます。モジュールファイルの詳細については、「モジュール」を参照してください。

Maven からライブラリをダウンロードする

  1. メインメニューで、ファイル | プロジェクト構造 Ctrl+Alt+Shift+S に移動し、ライブラリをクリックしてプロジェクトライブラリを追加するか、グローバルライブラリをクリックしてグローバルライブラリを追加します。

  2. Add をクリックし、Maven からを選択します。

  3. 次のダイアログで、ライブラリアーティファクトを指定します。正確な名前がわからない場合は、キーワードを入力して Search をクリックします。

    別のライブラリの場所を指定して、推移的な依存関係、ソースファイル、Javadoc ファイル、アノテーションをダウンロードするかどうかを選択することもできます。

    Downloading a library from Maven

IntelliJ IDEA は、Maven または Nexus パブリックリポジトリからライブラリをダウンロードします。カスタムリモートリポジトリを構成することもできます。

クラスをライブラリに追加する

ライブラリが追加されたら、さらにクラスを追加できます。

  1. メインメニューで、ファイル | プロジェクト構造に移動します。次に、グローバルライブラリをクリックしてグローバルライブラリを変更するか、ライブラリをクリックしてプロジェクトライブラリを変更します。

    モジュールライブラリを変更するには、メインメニューからファイル | プロジェクト構造を選択し、モジュール | 依存関係に移動します。変更するライブラリを選択し、Edit をクリックします。

    Adding classes to a library
  2. the Add button をクリックし、開いたダイアログで追加するクラスを選択します。

    Java ライブラリの場合、これらは個々の class および java ファイル、そのようなファイルを含むディレクトリおよびアーカイブ jar および zip、または Java ネイティブライブラリ .dll.so または .jnilib を含むディレクトリです。

  3. IntelliJ IDEA は選択されたファイルとフォルダーを分析し、それらの内容を適切なライブラリカテゴリ(クラス、ソース、ドキュメント、ネイティブライブラリの場所など)に自動的に割り当てます。

    IntelliJ IDEA がカテゴリを推測できない場合(たとえば、空のフォルダーを選択した場合)、ダイアログが表示され、そこでカテゴリを自分で指定することができます。

特定の推移的な依存関係を含める

推移的な依存関係のみを含める場合は、ライブラリのプロパティエディターを使用できます。

  1. メインメニューで、ファイル | プロジェクト構造 Ctrl+Alt+Shift+S に移動し、モジュール | 依存関係に移動します。

  2. 必要な Maven ライブラリを選択し、Edit をクリックします。

  3. 次のダイアログで編集をクリックし、推移的依存関係を含めるオプションの横にある構成をクリックします。

  4. ライブラリに含める依存関係を選択し、OK をクリックします。

ライブラリレベルを変更する

ライブラリをより高いレベルに移動する

IntelliJ IDEA では、プロジェクトまたはモジュールライブラリをより高いレベルに移動できます。これは、使用スコープを拡大したい場合に役立ちます。例: プロジェクト全体または IDE 全体でモジュールライブラリを使用する場合は、この手順を使用します。

  1. メインメニューで、ファイル | プロジェクト構造 Ctrl+Alt+Shift+S に移動し、変更するライブラリを見つけます。

  2. 必要なライブラリを右クリックして、プロジェクトライブラリに移動またはグローバルライブラリに移動を選択します。

    Moving a module library to a higher level

ライブラリを下位レベルにコピーする

下位レベルでライブラリのコピーを作成できます。例: プロジェクトライブラリにクラスを追加したいが、1 つのモジュールでのみ使用したい場合は、この手順を使用します。

  1. メインメニューで、ファイル | プロジェクト構造 Ctrl+Alt+Shift+S に移動し、変更するライブラリを見つけます。

  2. 必要なライブラリを右クリックして、プロジェクトライブラリにコピーまたはモジュールに追加を選択します。

    Copying a global library to a lower level

ライブラリアイテムを除外

IntelliJ IDEA を使用すると、IDE のパフォーマンスを向上させるために、ライブラリ項目を一時的に除外できます。フォルダー、アーカイブ(JAR など)、アーカイブ内のフォルダーを除外できます。

除外されたパッケージのクラスはコード補完候補リストに表示されず、そのようなクラスへの参照は未解決としてエディターに表示されます。ただし、コードをコンパイルまたは実行すると、ライブラリに除外されたアイテムがあるかどうかに関係なく、ライブラリは全体として使用されます。

プロジェクトまたはグローバルライブラリからアイテムを除外する

  1. メインメニューで、ファイル | プロジェクト構造 Ctrl+Alt+Shift+S に移動し、ライブラリをクリックします。

  2. Exclude をクリックして、除外するライブラリ項目を選択します。

モジュールライブラリからアイテムを除外する

  1. メインメニューで、ファイル | プロジェクト構造 Ctrl+Alt+Shift+S に移動し、モジュール | 依存関係を選択します。

  2. 変更するライブラリを選択し、Edit をクリックします。

  3. Exclude をクリックして、除外するライブラリ項目を選択します。

除外された項目には Excluded root アイコンが表示されます。ライブラリ項目を元の状態に戻すには、除外された項目を削除します。

カスタムリモートリポジトリを設定する

リモートリポジトリの完全なリストを表示し、設定でカスタムリポジトリを追加できます。プロジェクトのビルドツールとして Maven を使用していない場合でも、IntelliJ IDEA は Maven からライブラリをロードできることに注意してください。

  1. 設定ダイアログ Ctrl+Alt+S で、ビルド、実行、デプロイ | リモート Jar リポジトリに移動します。

  2. 対応するダイアログセクションで追加をクリックし、リポジトリの URL を指定します。

ライブラリドキュメントを構成する

ライブラリドキュメントを IntelliJ IDEA に追加して、クイックドキュメントポップアップのエディターから直接シンボルとメソッドシグネチャーに関する情報を取得できるようにすることができます。

オンラインで参照情報へのパスを指定して、外部ドキュメントを構成することもできます。外部ドキュメントは、ブラウザーで必要な情報を開くため、関連するシンボルに移動し、同時にさらに参照できるように情報を保持できます。

ライブラリのドキュメントパスを指定する

外部ライブラリのドキュメントを表示するには、最初にドキュメントの URL を設定します。

  1. プロジェクト構造ダイアログ Ctrl+Alt+Shift+S で、ライブラリを選択します。

  2. 必要なライブラリを選択し、Specify Documentation URL アイコンをクリックして、外部ドキュメントの URL を入力します。

    Specifying library documentation path
  3. 変更を適用し、ダイアログを閉じます。

プロジェクトにライブラリドキュメントを追加する

ダウンロードしたドキュメントをプロジェクトに追加して、オフラインでアクセスできるようにすることができます。

  1. メインメニューで、ファイル | プロジェクト構造 Ctrl+Alt+Shift+S に移動し、ライブラリをクリックします。

  2. ドキュメントを追加するライブラリを選択し、ダイアログの右側のセクションで the Add button をクリックします。

    Adding library documentation
  3. 開いたダイアログで、ドキュメントを含むファイルを選択し、オープンをクリックします。

  4. 変更を適用し、ダイアログを閉じます。

ドキュメントが構成されたら、エディターで開くことができます。

関連ページ:

Maven

IntelliJ IDEA は、構築プロセスの自動化に役立つ Maven との完全な機能統合をサポートしています。新しい Maven プロジェクトの作成、既存のプロジェクトのオープンと同期、既存の IntelliJ IDEA プロジェクトへの Maven サポートの追加、マルチモジュールプロジェクトの構成と管理を簡単に行うことができます。Maven プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを参照してくだ...

Gradle

IntelliJ IDEA は、Gradle との完全に機能的な統合をサポートし、構築プロセスの自動化を支援します。新しい Gradle プロジェクトを簡単に作成し、既存のプロジェクトを開いて同期し、リンクされた複数のプロジェクトを同時に操作して、管理できます。Gradle プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを参照してください。新規 Gradle プロジェクトを作成する新規プロジェクトウィザー...

IDE で使用されるディレクトリ

デフォルトでは、IntelliJ IDEA は、各 IDE インスタンスのユーザー固有のファイル(構成、キャッシュ、プラグイン、ログなど)をユーザーのホームディレクトリに保存します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。IDE ディレクトリの場所を変更するたとえば、ユーザープロファイルドライブの容量が不足している場合や低速ディスクにある場合、ホームディレクトリが暗号化されている(IDE の速度が低下している)場合、またはネットワークドライブにある場合は、デフォルトの...

モジュール

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

コードリファレンス情報

パラメーター情報:パラメーター情報ポップアップには、メソッド呼び出しと関数呼び出しのパラメーターの名前が表示されます。IntelliJ IDEA は、エディターで左括弧を入力するか、候補リストからメソッドを選択すると、1 秒 (1000 ミリ秒) 以内に、使用可能なすべてのメソッドシグネチャーを含むポップアップを自動的に表示します。ポップアップが閉じている場合、または IDE がポップアップを自動的に表示しないように構成されている場合は、ポップアップを明示的に呼び出すことができます。これを行う...