IntelliJ IDEA 2024.3 ヘルプ

IntelliJ IDEA を使用してアプリケーションをコンパイルおよびビルドする

IntelliJ IDEA のコンパイルおよびビルドプロセスは、ソースファイルをコンパイルし、外部ライブラリ、プロパティファイル、構成をまとめて、生きたアプリケーションを生成します。IntelliJ IDEA は、Java 仕様に従って動作するコンパイラーを使用します。

単一のファイルをコンパイルし、モジュールまたはプロジェクトの増分ビルドを使用して、プロジェクトを最初から再ビルドできます。

純粋な Java または Kotlin プロジェクトがある場合、IntelliJ IDEA はビルドプロセスを大幅に高速化する増分ビルドをサポートしているため、IntelliJ IDEA を使用してプロジェクトをビルドすることをお勧めします。

ただし、IntelliJ IDEA ネイティブビルダーは、ビルドスクリプトファイルがカスタムプラグインまたはタスクを使用している場合、Gradle または Maven プロジェクトを正しくビルドしない可能性があります。この場合、Gradle または Maven へのビルド委譲は、プロジェクトを正しくビルドできます。

単一のファイルまたはクラスをコンパイルする

  • エディターで必要なファイルを開き、メインメニューのビルド | 再コンパイル 'クラス名' (Ctrl+Shift+F9) に移動します。

    または、プロジェクトツールウィンドウで、必要なクラスを右クリックし、コンテキストメニューから再コンパイル 'クラス名' を選択します。

    コンパイルプロセス中にエラーが発生した場合、IntelliJ IDEA は警告メッセージとともにコンパイルを確認して出力をビルドするに表示します。

コンパイルの出力場所を変更する

ソースコードをコンパイルすると、IntelliJ IDEA はコンパイルされた .class ファイルを含む出力ディレクトリを自動的に作成します。

Compile output directory

IntelliJ IDEA は、出力ディレクトリ内に、モジュールごとにサブディレクトリも作成します。

サブディレクトリのデフォルトパスは次のとおりです。

  • ソース : <ProjectFolder>/out/production/<ModuleName>

  • テスト : <ProjectFolder>/out/test/<ModuleName>

プロジェクトレベルでは、出力パスの <ProjectFolder>/out 部分を変更することができます。そうした場合(<ProjectFolder>/out ではなく <OutputFolder> をいくつか指定する)、モジュールレベルでパスを再定義しないと、コンパイル結果は <OutputFolder>/production/<ModuleName><OutputFolder>/test/<ModuleName> になります。

モジュールレベルでは、モジュールソースとテストに個別に望ましいコンパイル出力場所を指定できます。

コンパイル出力フォルダーを指定する

  1. プロジェクト構造ダイアログ(ファイル | プロジェクト構造 Ctrl+Alt+Shift+S)を開きます。

  2. プロジェクト設定プロジェクトを選択し、プロジェクトコンパイラー出力フィールドで対応するパスを指定します。

    Project Structure dialog / Projects page

    モジュールの場合は、モジュール、必要なモジュール、パスタブを選択します。コンパイラー出力セクションの出力フォルダーの場所を変更します。

    Project Structure dialog / Module page

ビルド

ビルド the Build Project icon コマンドを実行すると、IntelliJ IDEA はビルドターゲット内のすべてのクラスをコンパイルし、出力ディレクトリ内に配置します。

ビルドターゲット内のクラスを変更してからビルドアクションを実行すると、IntelliJ IDEA は変更されたクラスのみをコンパイルするインクリメンタルビルドを実行します。IntelliJ IDEA は、クラスの依存関係も再帰的に構築します。

モジュールまたはプロジェクトをビルドする

  • コンパイルするモジュールまたはプロジェクトを選択し、ビルド | プロジェクトのビルド (Ctrl+F9) に移動します。

    IntelliJ IDEA は、コンパイル結果をコンパイルを確認して出力をビルドするに表示します。

モジュールの依存関係をプライマリモジュールに追加してモジュールをビルドすると、IntelliJ IDEA は依存モジュールもビルドし、プライマリモジュールと一緒に出力ディレクトリに表示します。依存するモジュールに独自のモジュールの依存関係がある場合、IntelliJ IDEA は依存関係が最も少ないモジュールからすべてを再帰的にコンパイルします。

Project Structure dialog / Module page

モジュールの依存関係の順序は、コンパイルを成功させるために非常に重要です。2 つの JAR ファイルに同じ名前のクラスが含まれている場合、IntelliJ IDEA コンパイラーは、クラスパスで見つけた最初の JAR ファイルのクラスを使用します。

詳細は、モジュールの依存関係を参照してください。

再ビルド

再構築コマンドを実行すると、IntelliJ IDEA は出力ディレクトリ全体をクリーンアップし、ビルドキャッシュを削除して、プロジェクトまたはモジュールを最初からビルドします。クラスパスのエントリが変更された場合に役立つ場合があります。例: プロジェクトが使用する SDK またはライブラリが追加、削除、変更されました。

モジュールまたはプロジェクトを再構築する

  • メインメニューで、プロジェクト全体の場合はビルド | プロジェクトの再ビルドに移動し、モジュールの再構築の場合はビルド | 「モジュール名」を再構築に移動します。

    IntelliJ IDEA は、ビルド結果をコンパイルを確認して出力をビルドするに表示します。

バックグラウンドコンパイル (auto-build)

プロジェクトに変更を加えるたびに、プロジェクトを自動的にビルドするように IntelliJ IDEA を構成できます。バックグラウンドコンパイルの結果は問題ツールウィンドウに表示されます。

バックグラウンドコンパイルを構成する

  1. Ctrl+Alt+S を押して設定を開き、ビルド、実行、デプロイ | コンパイラーを選択します。

  2. コンパイラーページで、自動的にプロジェクトをビルドするを選択します。

    クラスファイルに変更を加えると、IntelliJ IDEA は自動的にプロジェクトの増分ビルドを実行します。

    自動ビルドは、ファイルを保存するとき (Ctrl+S)、またはアプリケーションが N 秒間アイドル状態の場合にファイルを自動的に保存するときにもトリガーされます。システム設定ダイアログで選択したオプション。

実行する前にコンパイルする

デフォルトでは、アプリケーションを実行すると、IntelliJ IDEA は実行しようとしているクラスが含まれるモジュールをコンパイルします

その動作を変更したい場合は、実行 / デバッグ構成ダイアログで変更できます。

実行 / デバッグ構成を構成する

  1. メインメニューで、実行 | 実行構成の編集に移動します。

  2. 開いたダイアログで、新規作成するか、既存の実行構成を開きます。

  3. オプションを変更リンクをクリックします。

  4. 実行オプションの追加リストの起動前セクションで、起動前タスクの追加を選択します。タスクのリストが使用可能になり、ビルドが選択されます。the Close icon をクリックして無効にします。

    Run/Debug Configuration dialog: Before launch
  5. 新しい構成アクションを追加する必要がある場合は、the Add button をクリックし、開いたリストから目的のオプションを選択します。

    例: プロジェクトのビルドを選択した場合、IntelliJ IDEA は実行前にプロジェクト全体をビルドします。この場合、ビルドアクションを使用したビルドに含まれていなかった依存関係が考慮されます。ビルド、エラーチェックなしオプションを選択すると、コンパイル結果にエラーがあった場合でも、IntelliJ IDEA はアプリケーションを実行します。

    Run/Debug Configuration: Add new configuration.

コンパイルを確認して出力をビルドする

IntelliJ IDEA は、コンパイルとビルドの結果をビルドツールウィンドウで報告します。ビルドツールウィンドウは、エラーと警告に関するメッセージ、およびコンパイルの成功手順を表示します。

IntelliJ IDEA build output

auto-build を構成した場合、IntelliJ IDEA はメッセージに問題ツールウィンドウを使用します。ビルドが正常に実行された場合でも、ウィンドウは使用可能です。開くには、ステータスバーの自動ビルドをクリックします。

Problems tool window

メッセージをダブルクリックして、ソースコードの問題に移動します。コンパイラーの設定を調整する必要がある場合は、the Compiler Properties icon をクリックします。

アプリケーションを JAR にパッケージ化する

コードがコンパイルされて準備ができたら、アプリケーションを Java アーカイブ(JAR)にパッケージ化して、他の開発者と共有できます。ビルドされた Java アーカイブは、アーティファクトと呼ばれます。

JAR 用のアーティファクト構成を作成する

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

  2. the Add button をクリックし、JAR をポイントして、依存関係を持つモジュールからを選択します。

  3. メインクラスフィールドの右側で、the Browse button をクリックし、開いたダイアログでメインクラス(たとえば、HelloWorld (com.example.helloworld))を選択します。

    IntelliJ IDEA はアーティファクト設定を作成し、その設定をプロジェクト構造ダイアログの右側に表示します。

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

Creating an artifact configuration

JAR アーティファクトを構築する

  1. メインメニューで、ビルド | アーティファクトのビルドに移動します。

  2. 作成された .jarHelloWorld:jar)をポイントし、ビルドを選択します。

    out/artifacts フォルダーを見ると、そこに .jar ファイルがあります。

The JAR artifact is built

プロジェクトをビルドする場合、リソースルートに保存されているリソースは、デフォルトでコンパイル出力フォルダーにコピーされます。必要に応じて、出力フォルダー内に別のディレクトリを指定して、リソースを配置できます。

JAR アーティファクトに他のファイルを追加する

JAR アーティファクトに他のファイルを追加できます。たとえば、イメージファイル、構成ファイル、JAR ファイルなどを追加できます。

JAR アーティファクトにファイルを追加する

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

  2. 出力レイアウトで、the Add Copy of をクリックします。

  3. コンテキストメニューからファイルを選択します。

  4. 開いたダイアログでファイルを見つけて追加し、OK をクリックします。

  5. メインメニューで、ビルド | アーティファクトのビルドに移動します。

  6. 作成した .jar をポイントし、ビルドを選択します。

    ビルドされた JAR アーティファクトには追加されたファイルが含まれます。

パッケージ化された JAR を実行する

JAR にパッケージされた Java アプリケーションを実行するために、IntelliJ IDEA では専用の実行構成を作成することができます。

実行構成の作成

  1. Ctrl+Shift+A を押して、実行構成の編集アクションを見つけて実行します。

  2. 実行 / デバッグ構成ダイアログで、the Add button をクリックし、JAR アプリケーションを選択します。

  3. 新しい構成の名前を追加します。

    Creating a new run configuration
  4. JAR のパスフィールドで、the Browse button をクリックして、コンピューター上の JAR ファイルへのパスを指定します。

  5. 起動前the Add button をクリックし、表示されたダイアログでアーティファクトのビルドを選択します。

    これにより、実行構成を実行するたびに JAR が自動的に構築されます。

実行構成を使用すると、どの引数とオプションを使用して、アプリケーションの実行方法を定義できます。同じアプリケーションに対して、それぞれ独自の設定を持つ複数の実行構成を設定できます。

実行構成を実行する

  • ツールバーで、作成された構成を選択し、実行構成セレクターの右側にある the Run button をクリックします。または、ショートカットが必要な場合は Shift+F10 を押します。

    以前と同様に、実行ツールウィンドウが開き、アプリケーションの出力が表示されます。

Running the packaged application

プロセスが正常に終了した場合、アプリケーションは正しくパッケージ化されています。

関連ページ:

Gradle プロジェクト

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

Maven プロジェクト

IntelliJ IDEA を使用すると、Maven プロジェクトを管理できます。リンク、プロジェクトの無視、Maven および IntelliJ IDEA プロジェクトの変更の同期、ビルドおよび実行アクションの構成を行うことができます。POM に移動する Maven ツールウィンドウで、リンクされたプロジェクトを右クリックします。コンテキストメニューからソースに移動を選択します。IntelliJ IDEA は適切な Maven 構成ファイルに移動し、関連する POM がエディターで開きます。Maven...

モジュールの依存関係

モジュールは、SDK、JAR ファイル(ライブラリ)、プロジェクト内の他のモジュールに依存できます。コードをコンパイルまたは実行すると、モジュールの依存関係のリストを使用して、コンパイラーまたは JVM のクラスパスが形成されます。新しい依存関係を追加するメインメニューで、に移動し、をクリックします。をクリックして、依存関係の種類を選択します。JAR またはディレクトリ: コンピューター上のファイルから Java アーカイブまたはディレクトリを選択します。ライブラリ: 既存のライブラリを選択す...

Gradle ツールウィンドウ

Gradle プロジェクトを作成または開くと、Gradle ツールウィンドウが自動的に有効になります。右側のサイドバーの Gradle をクリックして、ツールウィンドウを開きます。ツールウィンドウには、Gradle リンクプロジェクト、そのタスク、依存関係、基になる build.gradle ファイルに加えられたすべての変更が表示されます。Gradle:このボタンをクリックすると、現在のビューを設定したりツールウィンドウの表示モードを変更したりするためのメニューが開きます。メニュー項目は、オンまたはオフ...

Maven ツールウィンドウ

Maven プロジェクトを作成または開くと、Maven ツールウィンドウが自動的に有効になります。Maven ツールウィンドウを使用して、利用可能な Maven プロジェクトを表示し、ソースと Javadoc をダウンロードし、ビルドライフサイクルのフェーズを実行します。ツールウィンドウには、ライフサイクル、プラグインサブノードとともに、各 Maven プロジェクトのノードが表示されます。pom.xml ファイルの少なくとも 1 つにプロファイル定義が含まれている場合、プロファイルノードがツールウィン...

システム設定

IntelliJ IDEA の一般的な動作を設定します。IDE を終了する前に確認 IntelliJ IDEA を閉じようとしたときに確認のダイアログを表示します。実行中のプロセスウィンドウを閉じたとき実行中のプロセスをどうするかを選択します。プロセスを終了する: プロセスを完全に停止します。切断: プロセスを実行したままにしますが、プロセスから切断します。確認する: 選択するアクションのダイアログを表示します。プロジェクト:起動時に前回のプロジェクトを開く前回 IntelliJ IDEA を閉...