コマンドラインからのカバレッジ分析の実行

サーバー上にdotCover Console Runnerを設定するには

1. 以下のいずれか 1 つを実行します
   • Visual Studioで、ReSharper | オプション | dotCover | リモートカバレッジに移動し、サーバーパッケージを取得するをクリックします。 dotCoverは、必要なすべてのファイルを含むアーカイブを生成します。
   • JetBrainsのウェブサイトのdotCoverコマンドラインツールパッケージをダウンロード(英語)。
2. コンソールランナーを設定するマシンにアーカイブをコピーします。
3. アーカイブからコンソールランナー実行ファイル（dotCover.exe）を開始するディレクトリにファイルを展開します。

単一ユニットテストプロジェクトをカバーする

1. ユニットテストプロジェクトをビルドします。
2. dotcover.exe があるディレクトリに移動します。

3. コンソールに次のコマンドを入力します。

   dotcover cover /TargetExecutable="D:\Program Files\NUnit 2.6\bin\nunit-console.exe" /TargetArguments="D:\Projects\TheApplication\bin\Debug\AppTests.dll" /Output="AppCoverageReport.html" /ReportType="HTML"

   説明

   • TargetExecutableはユニットテストフレームワークランナーへのパスです
   • TargetArgumentsはランナーに渡される引数で、コンパイルされたユニットテストアセンブリです: これらの引数にスペースを含むパスが含まれている場合は、二重引用符と円記号（例： ... /TargetArguments="\"D:\My Projects\My Application\bin\Debug\AppTests.dll""）を付けてエスケープする必要があります
   • 出力はレポートファイル名です。
   • ReportTypeはレポートのタイプです（この場合、HTMLレポートを生成します）
4. コンソールランナーが終了すると、 AppCoverageReport.html ファイルはdotCoverコンソールランナーと同じディレクトリに表示されます。このファイルを開いて、Webブラウザのカバレッジ結果を調べます。
5. また、XMLファイルでパラメータを渡すこともできます。これを行うには、コマンドラインで dotcover help cover coverage.xml と入力します。

6. 生成された coverage.xml ファイルを開き、設定パラメータを指定します。例：設定ファイルは次のようになります。

   <?xml version="1.0" encoding="utf-8"?> <AnalyseParams> <TargetExecutable>D:\Program Files\NUnit 2.6\bin\nunit-console.exe</TargetExecutable> <TargetArguments>D:\Projects\TheApplication\bin\Debug\AppTests.dll</TargetArguments> <Output>AppCoverageReport.html</Output> <ReportType>html</ReportType> </AnalyseParams>

7. dotcover cover coverage.xml を使用して、指定されたパラメータでカバレッジを実行します。

dotnetツールを使用してプロジェクト内の単位テストのカバレッジ分析を実行するには（手順1〜4はプロジェクトごとに1回）

1. 公式のnuget.orgサイトで、JetBrains.dotCover.CommandLineTools(英語)パッケージを見つけてください。
2. ないはユニットテストプロジェクトでこのパッケージを参照しますか？その代わりに、 .csproj ファイルを開き、パッケージ名とそのバージョンを含む行を ItemGroup 要素に追加します: 例えば：
   <ItemGroup> <DotNetCliToolReference Include="JetBrains.dotCover.CommandLineTools" Version="2018.2.0" /> <ItemGroup/>
3. コマンドラインで、単体テストプロジェクトを含むディレクトリに移動します。
4. 実行
   dotnet restore
   これにより、コンピュータにdotCoverコマンドラインツールがダウンロードされます。
5. カバレッジ分析でテストを実行する：
   dotnet dotcover test

XML設定ファイルを使用してカバレッジフィルタを設定するには

• カバレッジレポートから一部の項目（モジュール、クラス、メソッド）を除外するには、対応するエントリをExcludeFiltersノードに追加します: 例えば：
  ... <Filters> <ExcludeFilters> <FilterEntry> <ModuleMask>AdditionalTests</ModuleMask> </FilterEntry> <FilterEntry> <ClassMask>MainTests.Unit*</ClassMask> </FilterEntry> <FilterEntry> <ClassMask>MainTests.IntegrationTests</ClassMask> <FunctionMask>TestFeature1</FunctionMask> </FilterEntry> </ExcludeFilters> </Filters>

  ここに：

  • <ModuleMask>AdditionalTests</ModuleMask> - 対応するモジュールからのすべてのテストが除外されます。 AdditionalTests は拡張子のないアセンブリ名です。
  • <ClassMask>MainTests.Unit*</ClassMask> - 名前が MainTests.Unit で始まるすべてのクラスが除外されます。
  • <ClassMask>MainTests.IntegrationTests</ClassMask> <FunctionMask>TestFeature1</FunctionMask> - MainTests.IntegrationTests クラスの TestFeature1 メソッドは除外されます。 FunctionMask には常にメソッドの短い名前が含まれている必要があることに注意してください。 FilterEntryの要素を省略すると、dotCoverはこれをワイルドカードとみなします。例：この特定のケースで ClassMask を削除した場合、dotCoverはすべてのモジュールとクラスに属するすべての TestFeature1 メソッドを除外します。

• または、同じ種類の他のアイテムをすべて除外して目的のアイテムのみを含めるには、対応するエントリをIncludeFiltersノードに追加します。
• もう一つの選択肢は、その属性に基づいてクラスとメソッドをフィルタリングすることです: 例： System.Diagnostics.CodeAnalysis.ExcludeFromCodeCoverageAttribute 属性でマークされたメソッドを除外するために、 coverage.xml 設定ファイルに以下を追加することができます：
  ... <AttributeFilters> <AttributeFilterEntry> <ClassMask>System.Diagnostics.CodeAnalysis.ExcludeFromCodeCoverageAttribute</ClassMask> </AttributeFilterEntry> </AttributeFilters>

コマンドライン引数を使用してカバレッジフィルタを設定するには

• カバレッジ分析から項目を除外/含めるには、 /Filters パラメータを使用してコンソールランナーを実行する必要があります。たとえば（簡単にするため、カバレッジターゲットに関連するパラメータは省略しています）。
  dotCover.exe cover ... /Filters=-:module=AdditionalTests;-:type=MainTests.Unit*; -:type=MainTests.IntegrationTests;function=TestFeature1;

  この例は、XML構成上からの例と同等です。セミコロン（;）は、エントリをフィルタリングするだけでなく、フィルタエントリ内のアイテムも区切ることに注意してください。

• -: で始まるエントリは、 +: で始まるエントリを除外します（その逆もあります）。
• モジュールのみを除外/インクルードする必要がある場合は、 module キーワードを省略できます。
  dotCover.exe cover ... /Filters=-:AdditionalTests;
• それらの属性に基づいてクラスとメソッドを除外するには、 /AttributeFilters パラメーターを使用する必要があります: ex： System.Diagnostics.CodeAnalysis.ExcludeFromCodeCoverageAttribute 属性でマークされたメソッドをフィルタにかける：
  dotCover.exe cover ... /AttributeFilters=System.Diagnostics.CodeAnalysis.ExcludeFromCodeCoverageAttribute;

  セミコロン（;）はセパレータとして機能します。

別の手順で複数のプロジェクトのカバレッジを実行するには

1. 各テストプロジェクトでカバー（c）コマンドを実行するための2つの構成ファイルを作成します: MSTestを使用するTestProject1の testProject1.xml ：
   <?xml version="1.0" encoding="utf-8"?> <CoverageParams> <TargetExecutable>C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\MSTest.exe</TargetExecutable> <TargetArguments>TestProject1.dll</TargetArguments> <TargetWorkingDir>D:\Projects\TheApplication\bin\Debug</TargetWorkingDir> <Output>Snapshot1.dcvr</Output> </CoverageParams>
   NUnitを使用するTestProject2の testProject2.xml ：
   <?xml version="1.0" encoding="utf-8"?> <CoverageParams> <TargetExecutable>D:\Program Files\NUnit 2.6\bin\nunit-console.exe</TargetExecutable> <TargetArguments>TestProject2.dll</TargetArguments> <TargetWorkingDir>D:\Projects\TheApplication\bin\Debug</TargetWorkingDir> <Output>Snapshot2.dcvr</Output> </CoverageParams>

2. dotcover c testProject1.xml および dotcover c testProject2.xmlを使用して、各テストプロジェクトで cover (c) コマンドを実行します。その結果、カバレッジスナップショット、 Snapshot1.dcvr 、 Snapshot2.dcvrの2つが得られます。
3. 両方のスナップショットをマージするには、マージ（m）コマンドを実行します。
   dotcover m merge.xml
   <?xml version="1.0" encoding="utf-8"?> <MergeParams> <Source>Snapshot1.dcvr</Source> <Source>Snapshot2.dcvr</Source> <Output>MergedSnapshots.dcvr</Output> </MergeParams>

4. マージされたスナップショットからHTMLテストレポートを作成するには、報告書（r）コマンドを実行します
   dotcover r report.xml
   <?xml version="1.0" encoding="utf-8"?> <ReportParams> <Source>MergedSnapshots.dcvr</Source> <Output>CoverageReport.html</Output> <ReportType>html</ReportType> </ReportParams>