NCover
TeamCity は、TeamCity NUnit テストランナー経由で実行される NUnit テストに対して、NCover (1.x および 3.x) によるコードカバレッジをサポートしており、ウェブ UI、 TeamCity NUnit テストランチャー、 MSBuild 用 NUnit、 MSBuild 用 NUnit、 NAnt ビルドランナー用 NUnit のいずれかの方法で設定できます。
重要な注意事項
カバレッジを起動するには、カバレッジビルドを実行するエージェントに NCover と NCoverExplorer をインストールする必要があります。
カバレッジを有効にするためにビルドスクリプトを変更する必要はありません。
NCover/NCoverExplorer 引数を TeamCity NUnit テストランナーに明示的に渡す必要はありません。
NCover は、x86 プラットフォームで開始された .NET Framework 2.0 および 3.5 をサポートしています (NCover 3.x は x64 プラットフォームもサポートし、.NET Framework 4.0 で動作します)。 NCover と NUnit の両方に同じプラットフォームを指定していることを確認してください。
NCover 1.x の設定
NUnit テストが x86 環境で動作することを確認してください。
NCover 1.x を設定するには
ビルド構成を作成 / 編集している間、 ビルドステップ ページに移動します。
NCover をサポートするビルドステップ (.NET プロセスランナー、 MSBuild、 MSpec、 NAnt、 NUnit) のいずれかを追加し、ユニットテストを設定します。
.NET カバレッジツール の NCover (1.x) を選択してください。
NCover オプションを設定します - 使用可能なオプションの説明については、以下を参照してください。
オプション | 説明 |
|---|---|
NCover へのパス | ビルドエージェントにインストールされている NCover へのパスを指定するか、 |
NCoverExplorer へのパス | ビルドエージェントで NCoverExplorer へのパスを指定します。 |
追加の NCover 引数 | NCover に渡す追加の引数を入力してください。 |
プロファイルするアセンブリ | 改行で区切ったアセンブリ名 (パスと拡張機能を除く) を指定するか、すべてのアセンブリをプロファイル対象にする場合は、このフィールドを空白のままにします。 |
属性を除外 | カバレッジ統計から除外する、定義済みの .NET 属性(複数可) が付与されたクラスとメソッドを指定します。 |
レポートの種類 | レポートの種類を選択します。 詳細は NCoverExplorer のドキュメント(英語)を参照ください。 |
ソート | 優先ソートオプションを選択してください。 詳細は NCoverExplorer のドキュメント(英語)を参照ください。 |
追加の NCoverExplorer 引数 | NCoverExplorer に渡す追加の引数を指定してください。 ここにレポートの出力パスを入力したり、UI に対応するオプションがある引数を指定したりしないでください。 |
NCover 3.x の設定
必ず NCover と NUnit の両方に同じプラットフォームを指定してください。
NCover 3.x を設定するには
ビルド構成の作成 / 編集中に、ビルド手順ページに移動します。
NCover をサポートするビルドステップ (.NET プロセスランナー、 MSBuild、 MSpec、 NAnt、 NUnit) のいずれかを追加し、ユニットテストを設定します。
.NET カバレッジツール の NCover (3.x) を選択してください。
NCover オプションを設定します - 使用可能なオプションの説明については、以下を参照してください。
オプション | 説明 |
|---|---|
NCover 3 へのパス | NCover へのパスを指定します。 または、 |
NCover の実行 | カバレッジを実行する優先プラットフォームを選択します — x86 または x64。 選択したプラットフォームが NUnit テストで使用されるものと一致していることを確認してください。 |
NCover の引数 | NCover 引数、つまりプロファイルを作成するアセンブリおよびカバレッジツール固有の引数を指定します。 UI で指定できる引数をここに入力したり、生成されたレポートおよび NCover プロセスパラメーターの出力パスをここに入力したりしないでください。 |
NCover のレポート引数 | 出力パスを除いて、追加の NCover レポート引数を指定します。 レポートを入手するには |
NCover 結果を手動でレポートする
.NET コードカバレッジがビルドスクリプトによって収集され、TeamCity 内でレポートする必要がある場合 (たとえば Rake 、または TeamCity NUnit テストランチャー以外のテストランチャー経由でテストを実行する場合)、カバレッジデータを TeamCity に認識させる方法があります。 続きを読む: カバレッジレポートの手動設定。