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 システムプロパティを 偽 に設定します。

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

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

TeamCity NUnit テストランチャーは、NAnt ターゲットフレームワークによって指定された .NET Framework、つまり .NET Framework 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 は、実際にビルドに失敗するビルドの問題を報告します。 ビルドの問題は ビルド結果 ページに表示され、ビルドステータステキストにも影響します。

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

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

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 Report Processing ビルド機能を使用するか、 サービスメッセージを使ってテストレポートを手動で構成することもできます。

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 用 TeamCity アドインを使用して NUnit コンソールランナーを使用する方法を示しています (MSBuild の場合)。

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>