TeamCity On-Premises 2026.2 Help

Ipr (非推奨)

このランナーを使用すると、TeamCity で IntelliJ IDEA プロジェクトをビルドできます。
これは IntelliJ IDEA プロジェクト ランナーに置き換えられています。

このページには、 IPR 形式 ビルドランナーフィールドに関するリファレンス情報が含まれています。

Ipr ランナーは使用すべきではない

TeamCity 6.0 以降、Ipr ランナーは非推奨となり、別の実装アプローチを使用する IntelliJ IDEA プロジェクト ランナーに置き換えられています。 今後の TeamCity メジャーリリースのいずれかで、Ipr ランナーを使用するすべてのビルド構成は IntelliJ IDEA プロジェクトランナーに自動的に変換されます。 ランナーは特定の構成で異なる動作をする場合があるため、現在の Ipr ランナーベースの構成を新しいランナーに変更し、最終的に Ipr ランナーを無効にする前に設定を確認することを強くお勧めします。 また、新しく作成されたすべてのプロジェクトで IntelliJ IDEA プロジェクトランナーを使用し、問題がある場合はお知らせください。

サポートされる IntelliJ IDEA プロジェクト機能のスコープの違いに加えて、ランナーはテスト実行とカバレッジへのアプローチも異なります。
具体的には：

  • EMMA カバレッジは、IntelliJ IDEA プロジェクトランナーではサポートされていません。 EMMA を使用した場合は、IntelliJ IDEA カバレッジエンジンへの移行をお勧めします

  • IntelliJ IDEA プロジェクトランナーでは、JUnit テストは、Ant の Ipr ランナーの <JUnit> タスクとは対照的に、IntelliJ IDEA 共有実行構成を介して起動されます。

Ipr から IntelliJ IDEA プロジェクトランナーへの移行を実行するための推奨手順は次のとおりです。

  1. 既存の Ipr ランナーに JUnit テストランナーの設定が構成されている場合、たとえばセクションのすべての設定をテキストファイルにバックアップします。

  2. コードカバレッジ設定が構成されている場合は、これらの設定も保存します。 (関連する 問題(英語)も参照してください)

  3. ランナータイプを IntelliJ IDEA Project に変更します。 JUnit およびコードカバレッジオプションを除き、すべての設定が移行されます。

  4. JUnit テストを復元するには、IntelliJ IDEA で共有実行構成を作成し、対応するファイルをバージョン管理にコミットする必要があります。 実行構成の名前は、 実行する構成を実行する エリアで指定できます。

  5. カバレッジについては、保存した設定を使用してコードカバレッジオプションを新たに構成します。

IntelliJ IDEA プロジェクト設定

オプション

説明

プロジェクトへのパス

このフィールドを使用して、プロジェクトファイル（.ipr ）へのパスまたはプロジェクトディレクトリ（.idea ディレクトリを含むプロジェクトのルートディレクトリ）へのパスを指定します。 この情報は、このビルドランナーがプロジェクトの構造を理解するために必要です。

パスは、チェックアウトディレクトリからの相対パスである必要があります。

*.iml ファイルでグローバルライブラリとモジュールベースの JDK を検出する

このオプションをオンにすると、すべてのモジュールファイルが保存時にグローバルライブラリおよびモジュール JDK への参照を自動的にスキャンされます。 これにより、すべての参照が適切に解決されるようになります。

プロジェクトのチェック / 再解析

クリックしてプロジェクトを再解析し、IDEA プロジェクト（JDK のリストなど）からビルド設定をインポートします。

作業ディレクトリ

ビルド作業ディレクトリ へのパスを、 ビルドチェックアウトディレクトリ と異なる場合に入力します。

オプションで、チェックアウトディレクトリと異なる場合は指定します。

未解決のプロジェクトモジュールとパス変数

IntelliJ IDEA モジュールファイル（.iml ）が IPR ファイルから参照されている場合、このセクションが表示されます。

  • 見つからない

  • IPR ファイルで使用されるパス変数の値を入力できます

このセクションの値をリフレッシュするには、 プロジェクトのチェック / 再解析 をクリックしてください。

オプション

説明

<パス変数のお名前>

プロジェクトファイルに IntelliJ IDEA の設定ダイアログのパス変数ダイアログで定義されたパスマクロが含まれている場合、このフィールドが表示されます。 フィールドに値を設定 で、異なるビルドエージェントで使用されるプロジェクトリソースへのパスを指定します。

プロジェクト JDK

このセクションでは、プロジェクトで検出された JDK のリストを示します。

オプション

説明

JDK ホーム

このフィールドを使用して、プロジェクトの JDK ホームを指定します。

JDK Jar ファイルパターン

このリンクをクリックしてテキストエリアを開き、プロジェクト JDK の .jar ファイル用テンプレートを定義できます。 Ant ルールを使用して .jar ファイルパターンを定義します。
デフォルト値は Linux および Windows オペレーティングシステムで使用されます：

jre/lib/*.jar

macOS の場合は、次の行を使用してください。

lib/*.jar ../Classes/*.jar

IDEA ホーム

プロジェクトで IDEA JDK を使用する場合は、IDEA ホームディレクトリの場所を指定します

IDEA Jar ファイルパターン

このリンクをクリックして、IDEA JDK の .jar ファイルのテンプレートを定義できるテキスト領域を開きます。

追加の前処理/後処理 (Ant)

オプション

説明

ビルド前に実行

適切なフィールドに、ビルドを開始する前に実行する Ant スクリプトとターゲット（オプション）を入力します。 Ant ファイルへのパスは、プロジェクトのルートディレクトリからの相対パスである必要があります。

ビルド後に実行する

適切なフィールドに、ビルドの補完後に実行する Ant スクリプトとターゲット（オプション）を入力します。 Ant ファイルへのパスは、プロジェクトのルートディレクトリからの相対パスである必要があります。

JUnit テストランナー設定

オプション

説明

テストパターン

テストパターンを入力 リンクをクリックし、必要なテストパターンをテキストエリアに指定します。
これらのパターンは、 バッチテスト JUnit タスクセクションのパラメーターを生成するために使用されます。 各パターンは 含める または 除外 セクションを生成します。 これらのパターンは、テスト実行用のクラスパスを構成するためにも使用されます。 パターンで指定された各モジュールは、そのクラスパスを全体のクラスパスに追加します。
各パターンは別々の行に配置し、次のフォーマットにする必要があります：

[-]moduleName:[testFileNamePattern]

where:

  • [-]: パターンがマイナス文字で始まる場合、対応するファイルはビルドプロセスから除外されます。

  • モジュール名: この名前にはワイルドカードを含めることができます。

  • [テストファイル名パターン]: テストファイル名パターン のデフォルト値は **/*Test.java です。つまり、すべてのディレクトリ内で Test.java で終わるすべてのファイルです。 ファイルパターンには Ant 構文 を使用できます。 以下のサンプルは、"test" で終わるモジュールのすべてのテストファイルを含め、"ui" サブパッケージを含むパッケージのすべてのファイルを除外します：

*test:**/*Test.java -*:**/ui/**/*.java

テストの検索

IDEA プロジェクトでは、ユーザーはソースコードディレクトリを ソース または テスト ルートとしてマークできます。 このドロップダウンメニューを使用すると、テストを検索するディレクトリを指定できます。

  • すべてのプロジェクトソース全体: IDEA プロジェクトの ソース ディレクトリと テスト ディレクトリの両方でテストを探します。

  • テストソースのみ: テストルートとしてのみマークされたディレクトリを調べます。

テストのクラスパス

デフォルトでは、クラスパス全体は、テストの取得に使用されるモジュールのすべてのクラスパスで構成されます。 次の 2 つのオプションは、デフォルトのクラスパスを使用するか、指定されたモジュールから取得するかを定義します。

テストでクラスパスをオーバーライドする

このオプションをオンにすると、明示的に指定された単一のモジュールからテストクラスパスを定義できます。

JDK とクラスパスを使用するモジュール名

オプション テストでクラスパスをオーバーライドする がチェックされている場合、テストに使用されるクラスパスが指定されているモジュールを指定する必要があります。

JUnit Fork モード

コンボボックスから目的のフォークモードを選択します。

  • フォークしない: フォークは無効です。

  • テストごとにフォーク: fork が有効になり、各テストクラスが個別の JVM で実行されます

  • 一度だけフォーク: フォークが有効になり、すべてのテストクラスが単一の JVM で実行されます

各テストの新しいクラスローダーインスタンス

テストケースごとに新しいクラスローダーをインスタンス化する場合は、このオプションをオンにします。 このオプションは、 フォークしない オプションが選択されている場合にのみ使用可能です。

Ant ランタイムを含める

JUnit テストの実行に必要な Ant クラスを追加するには、このオプションをオンにします。 このオプションは、フォークモードが有効になっている場合（テストごとにフォーク または 一度だけフォーク ）に使用可能です。

JVM 実行可能ファイル

JVM の呼び出しに使用されるコマンドを指定します。 このオプションは、フォークモードが有効になっている場合（テストごとにフォーク または 一度だけフォーク ）に使用可能です。

エラー時にビルドを停止

テスト実行中にエラーが発生した場合にビルドを停止する場合は、このオプションをオンにします。

JUnit の JVM コマンドラインパラメーター

JUnit タスクに渡す JVM パラメーターを指定します。

作業ディレクトリをテストします

テスト用の作業ディレクトリへのパスを指定します。

テストのタイムアウト

テストがキャンセルされるまでの時間の経過をミリ秒単位で指定します。 フォークしない オプションが選択されている場合、この値は無視されます。

テスト失敗のフィードバック時間を短縮

次の二つのオプションを使用して、一部のテストを他のテストより先に実行するよう TeamCity に指示します。

最近失敗したテストを最初に実行する

チェックすると、TeamCity はまず、以前に完了したビルドまたは実行中のビルドで失敗したテスト、および失敗率の高いテスト (いわゆる 点滅 テスト) を実行します

最初に新しいテストと変更されたテストを実行する

チェックすると、他のどのテストよりも前に、TeamCity は実行中のビルドに含まれる変更リストで追加または変更されたテストを実行します。

詳細な Ant

生成された JUnit タスクが ant 用語で詳細な出力を生成する必要がある場合、このオプションをオンにします。

コードカバレッジ

コードカバレッジオプションの構成について詳しく見るには、 Java コードカバレッジの構成 ページを参照してください。

2026 年 9 月 11 日
IntelliJ IDEA プロジェクトKotlin スクリプト