TeamCity オンプレミス 2026.1 ヘルプ

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 ファイルで使用されるパス変数の値を入力できます

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

オプション

説明

<path_variable_name>

プロジェクトファイルに 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 テストランナーの設定

オプション

説明

テストパターン

型テストパターンリンクをクリックし、テキスト領域に必要なテストパターンを指定します。
これらのパターンは、batchtest JUnit タスクセクションのパラメーターを生成するために使用されます。各パターンは、include または exclude セクションのいずれかを生成します。これらのパターンは、テスト実行のクラスパスを作成するためにも使用されます。パターンでメンションされている各モジュールは、そのクラスパスをクラスパス全体に追加します。
各パターンは別々の行に配置する必要があり、次の形式になります。

[-]moduleName:[testFileNamePattern]

where:

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

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

  • [testFileNamePattern] : testFileNamePattern のデフォルト値は **/*Test.java です。つまり、すべてのディレクトリで Test.java で終わるすべてのファイルです。ファイルパターンには Ant 構文(英語)を使用できます。以下のサンプルには、「test」で終わるモジュールのすべてのテストファイルが含まれ、「ui」サブパッケージを含むパッケージからすべてのファイルが除外されます。

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

テストの検索

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

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

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

テストのクラスパス

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

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

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

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

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

JUnit Fork モード

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

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

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

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

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

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

Ant ランタイムを含める

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

JVM 実行可能ファイル

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

エラー時にビルドを停止

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

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

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

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

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

テストのタイムアウト

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

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

次の 2 つのオプションを使用して、TeamCity に他のテストの前にいくつかのテストを実行するよう指示します。

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

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

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

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

詳細な Ant

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

コードカバレッジ

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

2025 年 4 月 07 日