NUnit
NUnit ビルドランナーは、TeamCity サーバーで NUnit テストを実行するように設計されています。 ただし、 .NET ランナーを使用して NUnit テストを起動し、TeamCity でテストレポートを表示することもできます。 詳細については、 TeamCity での NUnit サポート の記事を参照してください。
既存および更新版 NUnit ランナー
バージョン 2024.07 では、既存ランナーと比べて .NET ランタイムまたは .NET Framework バージョンを選択できない、更新された NUnit ランナーが導入されました。 必要に応じて、 追加のコマンドラインパラメーター フィールドを使用してこれらの設定を指定してください。 また、更新版ランナーは古い NUnit 2.x.x バージョンをサポートしなくなりました。
バージョン 2024.07 では、更新されたランナーとレガシーランナーの両方が完全に機能し、 ビルドステップページから入手できます。 次のリリースサイクルでは、レガシーランナーをバンドル解除し、別のプラグインに移行する予定です。 完了したら、レガシーランナーを引き続き使用するには、 JetBrains マーケットプレイスからこのプラグインを手動でインストールする(英語)必要があります。 そのため、プロジェクトを更新された NUnit または通常の .NET ランナーに移行することをお勧めします。
NUnit のインストール
NUnit ビルドランナーを使用するには、次のいずれかのオプションを使用して TeamCity エージェントに NUnit NuGet パッケージをインストールする必要があります：
最初のビルドステップで、NuGet パッケージから NUnit をインストールするように指示します。
例: 次のように、
NUnit.コンソールNuGet パッケージをインストールする コマンドラインビルドステップを追加できます。%\teamcity.tool.NuGet.CommandLine.DEFAULT%\tools\nuget.exe install NUnit.Console -version 3.6.0 -o packages%\teamcity.ツール.NuGet.CommandLine.DEFAULT%文字列は、TeamCity エージェントにインストールされた NuGet への参照です。エージェントへの NuGet のインストールは 管理 | ツール ページで行えます。そこでは、インストール済みの NuGet バージョンのいずれかをデフォルトとしてマークすることもできます。
その後、
%\teamcity.ツール.NuGet.CommandLine.DEFAULT%パラメーター参照は、エージェント上の NuGet インストールパスに正しく解決されるはずです。
その後、nunit3-console はパッケージディレクトリの下に表示されるはずです。NUnit をすべてのビルドエージェントの標準の場所に手動でインストールし、NUnit ビルドステップで
nunit-コンソール.exeへのパスを構成します。
拡張機能のインストール
バージョン 3.2.0 以降、NUnit では NUnit.拡張機能.NUnitProjectLoader 拡張機能を TeamCity エージェントにインストールする必要があります。 バージョン 3.4.1 以降、NUnit では NUnit.拡張機能.TeamCityEventListener 拡張機能を TeamCity エージェントにインストールする必要があります。
バージョン 3.2.0 および 3.2.1 で拡張機能が見つからない場合、ビルドは警告なしで失敗します。 バージョン 3.4.1 以降は、インストールを促すメッセージが表示されます。
拡張機能は、 NUnit コンソールバージョン 3(英語) NuGet パッケージを使用して、個別のパッケージとして、または一括でインストールできます。
NUnit テスト設定
レガシー NUnit ランナーと更新された NUnit ランナーにはいくつかの違いがあります。
更新版ランナー設定
設定 | 説明 |
|---|---|
NUnit コンソール | プレインストールされたコンソールツールを選択するか、ファイル名を含む |
作業ディレクトリ | テストアセンブリのディレクトリと異なる場合は、 ビルド作業ディレクトリへのパスを指定します。 |
アプリケーション構成ファイルへのパス | テストの実行時に使用するアプリケーション構成ファイルへのパスを指定します。 パスは、絶対パスまたはチェックアウトディレクトリからの相対パスのいずれかである必要があります。 |
追加のコマンドラインパラメーター |
|
からテストを実行する | NUnit テストが保存されている .NET アセンブリを指定します。 複数のエントリはコンマで区切る必要があります。 MSBuild ワイルドカードがサポートされています。 アセンブリファイルへのパスは、 チェックアウトディレクトリに対する絶対パスまたは相対パスにする必要があります。 この例では、TeamCity はすべてのプロジェクトディレクトリでテストアセンブリを検索し、次のテストを実行します：
**\*.dll
ワイルドカードは、チェックアウトディレクトリに対して相対的に指定されます。 |
からテストを実行しない | テストするアセンブリのリストから除外する .NET アセンブリを指定します。 複数のエントリはコンマで区切る必要があります。 MSBuild ワイルドカードがサポートされています。 アセンブリファイルへのパスは、 チェックアウトディレクトリに対する絶対パスまたは相対パスにする必要があります。 この例では、TeamCity はこのディレクトリで指定されたテストを省略します：
**\obj\**\*.dll
ワイルドカードは、チェックアウトディレクトリに対して相対的に指定されます。 |
カテゴリを含める | 実行するテストの NUnit カテゴリを指定します。 複数のエントリはコンマで区切る必要があります。 NUnit 3.0 以降、カテゴリ式はサポートされておらず、 NUNit ドキュメント(英語)に従ってコマンドラインから設定する必要があります。 |
カテゴリを除外 | 実行するテストから除外する NUnit カテゴリを指定します。 複数のエントリはコンマで区切る必要があります。 NUnit 3.0 以降、カテゴリ式はサポートされておらず、 NUNit ドキュメントで説明されているようにコマンドラインで設定する必要があります。 |
テスト失敗のフィードバック時間を短縮 | このオプションを使用して、一部のテストを他のテストより先に実行するよう TeamCity に指示します。 |
既存ランナー設定
設定 | 説明 |
|---|---|
NUnit ランナー | テストの実行に使用する NUnit バージョンを選択します。 使用可能な設定のセットは、選択したバージョンによって異なります。 |
NUnit コンソール | プレインストールされたコンソールツールを選択するか、ファイル名を含む このオプションは、NUnit 3.0 が選択されている場合にのみ使用できます。 |
作業ディレクトリ | テストアセンブリのディレクトリと異なる場合は、 ビルド作業ディレクトリへのパスを指定します。 このオプションは、NUnit 3.0 が選択されている場合にのみ使用できます。 |
アプリケーション構成ファイルへのパス | テストの実行時に使用するアプリケーション構成ファイルへのパスを指定します。 パスは、絶対パスまたはチェックアウトディレクトリからの相対パスのいずれかである必要があります。 このオプションは、NUnit 3.0 が選択されている場合にのみ使用できます。 |
追加のコマンドラインパラメーター |
このオプションは、NUnit 3.0 が選択されている場合にのみ使用できます。 |
.NET ランタイム | プラットフォーム ドロップダウンメニューから、x64 マシンで目的の実行モードを選択します。 サポートされている値は、 バージョン ドロップダウンメニューから、必要な .NET Framework バージョンを選択します。 サポートされている値は次のとおりです: |
からテストを実行する | NUnit テストが保存されている .NET アセンブリを指定します。 複数のエントリはコンマで区切る必要があります。 MSBuild ワイルドカードがサポートされています。 アセンブリファイルへのパスは、 チェックアウトディレクトリに対する絶対パスまたは相対パスにする必要があります。 この例では、TeamCity はすべてのプロジェクトディレクトリでテストアセンブリを検索し、次のテストを実行します：
**\*.dll
ワイルドカードは、チェックアウトディレクトリに対して相対的に指定されます。 |
からテストを実行しない | テストするアセンブリのリストから除外する .NET アセンブリを指定します。 複数のエントリはコンマで区切る必要があります。 MSBuild ワイルドカードがサポートされています。 アセンブリファイルへのパスは、 チェックアウトディレクトリに対する絶対パスまたは相対パスにする必要があります。 この例では、TeamCity はこのディレクトリで指定されたテストを省略します：
**\obj\**\*.dll
ワイルドカードは、チェックアウトディレクトリに対して相対的に指定されます。 |
カテゴリを含める | 実行するテストの NUnit カテゴリを指定します。 複数のエントリはコンマで区切る必要があります。 NUnit 3.0 以降、カテゴリ式はサポートされておらず、 NUNit ドキュメント(英語)に従ってコマンドラインから設定する必要があります。 |
カテゴリを除外 | 実行するテストから除外する NUnit カテゴリを指定します。 複数のエントリはコンマで区切る必要があります。 NUnit 3.0 以降、カテゴリ式はサポートされておらず、 NUNit ドキュメントで説明されているようにコマンドラインで設定する必要があります。 |
アセンブリごとの実行プロセス | 新しいプロセスで各アセンブリを実行する場合は、このオプションを選択します。 このオプションは、NUnit バージョン 3.0 より前の レガシー NUnit ランナーでのみ使用できます。 |
テスト失敗のフィードバック時間を短縮 | このオプションを使用して、一部のテストを他のテストより先に実行するよう TeamCity に指示します。 |
NUnit コードカバレッジ
コードカバレッジオプションの構成については、 この記事を参照してください。
NUnit 3.x では、カバレッジツールとしてサポートされているのは JetBrains dotCover のみです。