TeamCity での NUnit サポート

TeamCity は、コマンドラインから使用できる独自の NUnit テストランチャーを提供します。テストは渡されたパラメーターに従って実行され、プロセスが TeamCity ビルドエージェント環境内で実行される場合、結果は TeamCity エージェントに報告されます。

次のコマンドラインオプションを TeamCity NUnit テストランチャーに渡すことができます。

このセクションでは、nunit2 タスクが構成された NAnt ビルドスクリプトがすでにあり、既存のビルドスクリプトに変更を加えずに TeamCity がテストレポートを追跡することを前提としています。それ以外の場合は、ビルド構成の手順の 1 つとして NUnit ビルドランナーを追加することを検討してください。

標準の nunt2 タスクを介して NAnt ビルドで定義されたテストを追跡するために、TeamCity はカスタムタスク(英語)の実装を提供し、元の <nunit2> タスクを独自のタスクに自動的に置き換えます。ビルドがトリガーされると、TeamCity は <nunit2> の独自の実装を使用して TeamCity NUnit テストランチャーを起動します。これにより、ビルドスクリプトを変更せずにそのままにして、TeamCity でオンザフライのテストレポートを受け取ることができます。

TeamCity で元の nunit2 タスクを置き換えたくない場合は、次のオプションを検討してください。

• NUnit 用の TeamCity アドインを備えた NUnit コンソールを使用します。

• XML テストレポートプラグインを介して XML テスト結果をインポートします。

• コマンドライン NUnit テストランチャーを使用します。

• サービスメッセージを介してレポートテストを手動で構成します。

• nunit2 タスクの置換を使用不可にするには、teamcity.dotnet.nant.replaceTasks システムプロパティを false に設定します。

TeamCity の nunt2 タスク実装は、ビルドスクリプト内の NAnt <property> タスクとして、またはビルド構成 | ビルドパラメーターのシステムプロパティとして指定できる追加オプションをサポートします。

TeamCity <nunit2> タスクの実装では、次のオプションがサポートされています。

TeamCity NUnit テストランチャーは、NAnt ターゲットフレームワークによって指定された .NET フレームワーク、つまり .NET フレームワーク 1.1, 2.0, 4.0 ランタイムでテストを実行します。TeamCity は、<nunit2> タスクのテストカテゴリもサポートしています。

リストされたプロパティを NAnt ビルドスクリプトに追加すると、TeamCity に依存します。これを回避するには、ビルド構成でシステムプロパティとしてプロパティを指定するか、<if> タスクを追加することを検討してください。

サンプル

開始テストは、.NET 2.0 の x64 モードで単一のアセンブリファイルを形成します。

C2 ではなく、カテゴリ C1 からすべてのテストを実行します。

テストを実行する NUnit のバージョンを明示的に指定します。
この場合、nunit2 タスク呼び出しの前に次のプロパティを追加する必要があることに注意してください。

このセクションでは、MSBuild から NUnit を使用する方法について説明します。

• 3.0 より前の NUnit 用

• NUnit 3.0 以降用

MSBuild の場合、TeamCity はスクリプトインタラクションの構築と同じオプションを実装する次のサービスタスクを提供します。

TeamCitySetBuildNumber では、ビルド番号を変更できます。

{build.number} を古いビルド番号のプレースホルダーとして使用できます。

TeamCityProgressMessage では、進行状況メッセージを書き込むことができます。

TeamCityPublishArtifacts では、MSBuild アイテムグループのすべてのアーティファクトを公開できます。

TeamCityReportStatsValue は、統計値を公開するための便利なタスクです。

TeamCityBuildProblem は、実際にビルドに失敗するビルドの問題を報告します。ビルドの問題はビルド結果ページに表示され、ビルドステータステキストにも影響します。

• 必須の description 属性は、ビルドの問題を説明する人間が読めるテキストです。デフォルトでは、description はビルドステータステキストに表示されます。

• identity はオプションの属性であり、特定のビルド問題インスタンスを特徴付けます。同じ問題が発生した場合（たとえば、同じコンパイルエラー）、ビルド全体で変更されるべきではありません。最大 60 文字の有効な JavaID である必要があります。デフォルトでは、identity は description に基づいて計算されます。

TeamCitySetStatus は、現在のビルドステータステキストを変更するタスクです。

{build.status.text は、古いステータステキストに置き換えられます。ステータスには SUCCESS 値を指定できます。

NUnit アドインは、NUnit コアにプラグインし、動作方法を変更する拡張機能です。詳細については、NUnit アドインページ(英語)を参照してください。このセクションでは、NAnt、MSBuild、NUnit ConsoleLauncher の NUnit アドインサポートについて説明します。

TeamCity NUnit アドインはバージョン 3.0 より前の NUnit をサポートします。それ以降のバージョンについては、このセクションを参照してください。

NUnit コンソール(英語)を介して NUnit テストを実行し、TeamCity テストランナーを起動せずに TeamCity でテスト結果を追跡する場合、最善の解決策は NUnit 用の TeamCity アドインを使用することです。このアドインを NUnit にプラグインすると、テストが TeamCity サーバーに自動的に報告されます。

または、XML レポート処理ビルド機能を使用するか、サービスメッセージを使用してテストレポートを手動で構成するかを選択できます。

TeamCity でテスト結果を確認できるようにするには:

1. ビルドでは、TeamCity アドインへのパスをシステムプロパティ teamcity.dotnet.nunitaddin (MSBuild の場合は teamcity_dotnet_nunitaddin) に設定し、このパスの末尾に NUnit のバージョンを追加します。例:

   • NUnit 2.4.X の場合は ${teamcity.dotnet.nunitaddin}-2.4.X.dll （MSBuild 用）を使用してください: $(teamcity_dotnet_nunitaddin)-2.4.X.dll）。
     NUnit 2.4.7 の例: NAnt: ${teamcity.dotnet.nunitaddin}-2.4.7.dll , MSBuild: $(teamcity_dotnet_nunitaddin)-2.4.7.dll .

   • NUnit 2.5.0 alpha 4 の場合は、${teamcity.dotnet.nunitaddin}-2.5.0.dll (MSBuild の場合は $(teamcity_dotnet_nunitaddin)-2.5.0.dll) を使用します。

2. .dll および .pdb TeamCity アドインファイルを NUnit アドインディレクトリにコピーします。

これらのファイルを一度コピーすることもできますが、これらのファイルは TeamCity によって更新される可能性があるため、ビルドごとに TeamCity アドインファイルが NUnit アドインディレクトリにコピーされるようにビルドを構成することを強くお勧めします。

次の例は、NUnit 2.4.7 (MSBuild 上) の TeamCity アドインで NUnit コンソールランナーを使用する方法を示しています。

NUnit の環境変数を明示的に設定する必要がある場合は、%system.teamcity.dotnet.nunitaddin% の値参照を使用して環境変数を指定します。詳細については、この記事を参照してください。

NUnit 2.4.8 の問題
NUnit 2.4.8 には以下の既知の問題がある: NUnit 2.4.8 ランナーは、作成された AssemblyName オブジェクトに従ってアセンブリをロードしようとします。ただし、NUnit 2.4.8 の addins フォルダーはアプリケーションプローブパスに含まれていません。その結果、NUnit 2.4.8 はコンソールモードでアドインをロードできません。
この問題を解決するには、次のいずれかの回避策を使用することをお勧めします。

• TeamCity アドインアセンブリを NUnit bin ディレクトリと bin/addins ディレクトリの両方にコピーします。

• NUnit-Console.exe.config にパッチを適用して、アプリケーションプローブパスへのアドインを含めます。次のコードを config/runtime 要素に追加します。

  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">       <probing privatePath="addins"/> </assemblyBinding>