JetBrains dotCover

dotCover の設定

dotCover カバレッジエンジンは、ラインカバレッジではなくステートメントカバレッジをレポートします。

異なるビルドでコンパイルしてテストする

一貫したカバレッジレポートを作成するには、dotCover はビルドチェックアウトディレクトリでソースファイルを見つけることができる必要があります。バイナリをビルドして同じビルドでカバレッジを収集する場合、または異なるビルドを使用しますが、スナップショット依存関係を使用する場合は簡単です。そして同じ VCS 設定と同じエージェント。

別のビルドでバイナリをビルドし、別のチェックアウト設定を使用して別のコードでコードカバレッジを収集する必要がある場合は、いくつかの追加のプロパティが必要です。以下のように仮定されます。

• ビルド構成 A はコードをデバッグ情報でコンパイルし、アセンブリと .pdb ファイルでアーティファクトを作成します。

• ビルド構成 B は、dotCover を有効にしてテストを実行し、A にスナップショット依存関係があります。

B のビルド結果のコードカバレッジタブにソースコードを表示するには、B を A と同じ VCS ルートにポイントして、適切な場所（チェックアウトルート）にソースコードを取得し、同じ場所からのビルドにアーティファクトの依存関係を追加する必要があります。A のチェーン（dotCover が .pdb ファイルからソースへのパスを取得するため）。

また、TeamCity にソースコードの場所を教える必要があります。これを行うには、以下の手順を実行します。

1. 値 %teamcity.build.checkoutDir% の teamcity.dotCover.sourceBase 構成パラメーターをコンパイル用ビルド構成 A に追加します。

2. 値 %dep.btA.teamcity.dotCover.sourceBase%=>%teamcity.build.checkoutDir% を使用して、構成パラメーター dotNetCoverage.dotCover.source.mapping をテスト構成 B に追加します。ここで、btA は、構成 A の実際の ID です。

スタンドアロン dotCover ランナー

バージョン 2024.03 以降では、.NET および NUnit ランナーで「.NET カバレッジ」を有効にするだけでなく、スタンドアロンの dotCover ランナーを使用して JetBrains dotCover を呼び出すこともできます。

このランナーを使用すると、次のことが可能になります。

• dotCover カバレッジプロファイルでプロセスを起動し、独自のスナップショットを生成します。

• 前の手順で生成されたスナップショットを結合して、コードカバレッジタブに表示される統合レポートを作成します。

詳細については、dotCover を参照してください。

バンドル dotCover バージョン

サーバー管理 | ツールページで dotCover のインストールされたバージョンを見ることができます。バンドルされているバージョンがデフォルトとして設定されています。他のバージョンをインストールしてデフォルト設定を変更することができます。

クロスプラットフォーム dotCover

TeamCity は、クロスプラットフォーム JetBrains dotCover バージョン 2019.2.3+ をサポートすることにより、Linux および macOS 上の .NETCore プロジェクトのカバレッジを収集できます。

dotCover 2019.2.3 for Windows は TeamCity にバンドルされています。Windows 以外のプラットフォームでコードカバレッジを収集する必要がある場合は、管理 | ツールにクロスプラットフォーム dotCover.GlobalTool(英語) を追加し、.NET ビルドステップで dotCover カバレッジを有効にします。Windows でもクロスプラットフォーム dotCover を使用する場合は、エージェントに .NET フレームワーク SDK 4.6.1+ がインストールされていることを確認してください。

コンテナーラッパー拡張機能を使用して、コンテナー内で dotCover コードカバレッジ分析を実行することもできます。