コード カバレッジを使用した、テストされるプロジェクトのコード割合の確認
単体テストなどのコード化されたテストによって実際にテストされるプロジェクトのコードの割合を調べるには、Visual Studio のコード カバレッジ機能を使用できます。バグから効果的に保護するには、コードの大部分を "カバー" するようにテストを実行する必要があります。
コード カバレッジ分析は、マネージ (CLI) コードにもアンマネージ (ネイティブ) コードにも適用できます。
コード カバレッジは、テスト エクスプローラーを使用してテスト メソッドを実行する場合のオプションです。結果テーブルには、各アセンブリ、クラス、およびメソッドで実行されたコードの割合が表示されます。また、ソース エディターには、どのコードがテストされたかが表示されます。
.png "色分けされたコード カバレッジの結果")
要件
- Visual Studio Ultimate, Visual Studio Premium
テスト エクスプローラーで単体テストのコード カバレッジを分析するには
[テスト] メニューの [コード カバレッジの分析] を選択します。
どの行が実行されたかを確認するには、
![[コード カバレッジの色分けを表示] アイコン](images/dd537628.codecoverage-showcoloringicon(vs.120).png "[コード カバレッジの色分けを表示] アイコン")
[コード カバレッジの色分け表示] を選択します。色を変更したり太字を使用したりする場合は、[ツール]、[オプション]、[環境]、[フォントおよび色]、[設定の表示: テキスト エディター] の順に選択します。[表示項目] でカバレッジ項目を調整します。
結果が低カバレッジを示していた場合は、コードのどの部分が実行されていないかを調べ、その部分をカバーするテストをさらに作成します。開発チームは、通常、約 80% のコード カバレッジを目標にします。状況によっては、より低いカバレッジでも許容されます。たとえば、一部のコードが標準テンプレートから生成される場合は、より低いカバレッジでも許容されます。
.gif "ヒント") ヒント |
|---|
正確な結果を得るには、次の点に注意します。
期待した結果が得られない場合は、「トラブルシューティング コード カバレッジ」を参照してください。.コードを更新した後は、コード カバレッジを忘れずに再度実行します。コードの変更後やテストの実行後に、カバレッジ結果とコードの色分けは自動的には更新されません。 |
ブロック単位または行単位で報告する
コード カバレッジは、"ブロック" 単位でカウントされます。ブロックは、エントリ ポイントと終了ポイントを 1 つだけ持つ、コードの部分です。プログラムの制御フローがテストの実行中にブロックを通過すると、そのブロックはカバー済みとしてカウントされます。ブロックが使用された回数は、結果には影響しません。
テーブル ヘッダーで [列の追加と削除] を選択して、結果を行単位で表示することもできます。テストの実行がコードのいずれかの行内のすべてのコード ブロックを処理すると、1 行としてカウントされます。実行されたコード ブロックと実行されなかったコード ブロックが行内に含まれている場合は、部分行としてカウントされます。
行単位での割合の方が、ソース コードで見ることができるフラグメントのサイズに正確に対応するため、一部のユーザーは行単位でのカウントを選びます。計算の長いブロックは、複数の行にわたっていても、1 つのブロックとしてカウントされます。
コード カバレッジの結果を管理する
[コード カバレッジの結果] ウィンドウには、通常、最新の実行の結果が表示されます。結果は、テスト データを変更したり、テストの一部だけを実行したりすると、そのたびに異なります。
コード カバレッジ ウィンドウを使用して、以前の結果や、他のコンピューター上で取得した結果を表示することもできます。
いくつかの実行 (たとえば、異なるテスト データを使用した実行) の結果をマージできます。
以前の結果のセットを表示するには、それをドロップダウン メニューから選択します。メニューには一時的な一覧が表示され、新しいソリューションを開くとクリアされます。
以前のセッションの結果を表示するには、[コード カバレッジの結果のインポート] を選択し、ソリューションの TestResults フォルダーに移動して、.coverage ファイルをインポートします。
.coverage ファイルの生成後、ソース コードを変更した場合は、カバレッジの色分けが正しくない場合があります。
結果をテキストとして読みやすくするには、[コード カバレッジの結果のエクスポート] を選択します。他のツールで処理したり電子メールで簡単に送信したりすることができる、読める形式の .coveragexml ファイルが生成されます。
結果を他のユーザーに送信するには、.coverage ファイルまたはエクスポートされた .coveragexml ファイルを送信します。受け取ったユーザーは、ファイルをインポートできます。同じバージョンのソース コードを持っていれば、カバレッジの色分けも表示できます。
さまざまな実行による結果をマージする
状況によっては、テスト データに応じて、コード内の異なるブロックが使用されます。そのため、異なるテスト実行の結果を結合する必要がある場合があります。
たとえば、入力が "2" のテストを実行したときに、特定の関数の 50% がカバーされるとします。入力を "-2" にして再度テストを実行すると、カバレッジの色分けビューで、関数の残りの 50% がカバーされていることがわかるとします。ここで、2 つのテスト実行の結果をマージすると、レポートやカバレッジの色分けビューで、関数の 100% がカバーされたことが表示されます。
そのためには、![[コード カバレッジ] ウィンドウの [マージ] ボタンのアイコン](images/dd537628.codecoverage-mergeicon(vs.120).png "[コード カバレッジ] ウィンドウの [マージ] ボタンのアイコン")
[コード カバレッジ結果のマージ] を使用します。最新の実行またはインポートされた結果を任意の組み合わせで選択できます。エクスポートされた結果を結合する場合は、まず、それらをインポートする必要があります。
マージ操作の結果を保存するために、[コード カバレッジの結果のエクスポート] を使用します。
マージの制限事項
バージョンが異なるコードのカバレッジ データをマージすると、結果は個別に表示され、結合はされません。完全に結合された結果を取得するには、同じビルドのコードを使用し、テスト データだけを変更します。
エクスポートしてからインポートされた結果ファイルをマージした場合は、行単位の結果のみを表示でき、ブロック単位の結果は表示できません。行データを表示するには、[列の追加と削除] コマンドを使用します。
ASP.NET プロジェクトのテスト結果をマージした場合は、個別のテストの結果は表示されますが、結合された結果は表示されません。このようになるのは、ASP.NET の成果物自体だけです。他のアセンブリの結果は結合されます。
コード カバレッジの結果から要素を除外する
コードがテキスト テンプレートから生成された場合のように、コード内の特定の要素をカバレッジのスコアから除外する必要があることがあります。その場合は、コード要素であるクラス、構造体、メソッド、プロパティ、プロパティ set または get アクセス操作子、およびイベントに、属性 System.Diagnostics.CodeAnalysis.ExcludeFromCodeCoverage を追加します。クラスを除外しても、派生クラスは除外されないことに注意してください。
たとえば、次のようにします。
using System.Diagnostics.CodeAnalysis;
...
public class ExampleClass1
{
[ExcludeFromCodeCoverage]
void ExampleMethod() {...}
[ExcludeFromCodeCoverage] // exclude property
int ExampleProperty1
{ get {...} set{...}}
int ExampleProperty2
{
get
{
...
}
[ExcludeFromCodeCoverage] // exclude setter
set
{
...
}
}
}
[ExcludeFromCodeCoverage]
class ExampleClass2 { ... }
Imports System.Diagnostics.CodeAnalysis
Class ExampleClass1
<ExcludeFromCodeCoverage()>
Public Sub ExampleSub1()
...
End Sub
' Exclude property
< ExcludeFromCodeCoverage()>
Property ExampleProperty1 As Integer
...
End Property
' Exclude setter
Property ExampleProperty2 As Integer
Get
...
End Get
<ExcludeFromCodeCoverage()>
Set(ByVal value As Integer)
...
End Set
End Property
End Class
<ExcludeFromCodeCoverage()>
Class ExampleClass2
...
End Class
// A .cpp file compiled as managed (CLI) code.
using namespace System::Diagnostics::CodeAnalysis;
...
public ref class ExampleClass1
{
public:
[ExcludeFromCodeCoverage]
void ExampleFunction1() { ... }
[ExcludeFromCodeCoverage]
property int ExampleProperty2 {...}
property int ExampleProperty2 {
int get() { ... }
[ExcludeFromCodeCoverage]
void set(int value) { ... }
}
}
[ExcludeFromCodeCoverage]
public ref class ExampleClass2
{ ... }
ネイティブ C++ コード内の要素を除外する
C++ コードでアンマネージ (ネイティブ) 要素を除外するには:
#include <CodeCoverage\CodeCoverage.h>
...
// Exclusions must be compiled as unmanaged (native):
#pragma managed(push, off)
// Exclude a particular function:
ExcludeFromCodeCoverage(Exclusion1, L"MyNamespace::MyClass::MyFunction");
// Exclude all the functions in a particular class:
ExcludeFromCodeCoverage(Exclusion2, L"MyNamespace::MyClass2::*");
// Exclude all the functions generated from a particular template:
ExcludeFromCodeCoverage(Exclusion3, L"*::MyFunction<*>");
// Exclude all the code from a particular .cpp file:
ExcludeSourceFromCodeCoverage(Exclusion4, L"*\\unittest1.cpp");
// After setting exclusions, restore the previous managed/unmanaged state:
#pragma managed(pop)
以下のマクロを使用します。
-
ExcludeFromCodeCoverage(ExclusionName, L"FunctionName");
ExcludeSourceFromCodeCoverage(ExclusionName, L"SourceFilePath");
ExclusionName は任意の一意の名前です。
FunctionName は完全修飾関数名です。ワイルドカードを含めることができます。たとえば、クラスのすべての関数を除外するには、MyNamespace::MyClass::* と記述します。
SourceFilePath は .cpp ファイルのローカル パスまたは UNC パスです。ワイルドカードを含めることができます。次の例では、\\MyComputer\Source\UnitTests\*.cpp という特定のディレクトリのすべてのファイルが除外されます。
#include <CodeCoverage\CodeCoverage.h>
除外マクロの呼び出しは、いずれかの名前空間またはクラス内ではなく、グローバル名前空間に配置します。
除外は単体テスト コード ファイルまたはアプリケーション コード ファイル内に配置できます。
除外は、コンパイラ オプションを設定するか、#pragma managed(off) を使用して、アンマネージ (ネイティブ) コードとしてコンパイルする必要があります。
[!メモ]
C++/CLI コード内の関数を除外するには、関数に [System::Diagnostics::CodeAnalysis::ExcludeFromCodeCoverage] 属性を適用します。これは、C# の場合と同じです。
追加の要素を含めるか除外する
コード カバレッジ分析の対象となるのは、読み込まれ、.dll または .exe ファイルと同じディレクトリ内の .pdb ファイルを利用できるアセンブリだけです。そのため、状況によっては、適切な .pdb ファイルのコピーを取得することによって、対象となるアセンブリのセットを拡張できます。
.runsettings ファイルを記述すると、コード カバレッジ分析の対象としてどのアセンブリと要素を選択するかをより詳細に制御できます。たとえば、クラスに属性を追加せずに、特定の種類のアセンブリを除外できます。詳細については、「コード カバレッジ分析のカスタマイズ」を参照してください。
ビルド サービスでコード カバレッジを分析する
コードをチェックインすると、テストがビルド サーバー上で、他のチーム メンバーによる他のすべてのテストと共に実行されます。まだこのセットアップを行っていない場合は、「ビルド プロセスでのテストの実行」を参照してください。これによって、プロジェクト全体のカバレッジに関する最新の全体像が得られるため、ビルド サービスのコード カバレッジを分析する場合に便利です。これには、自動化されたシステム テストと、通常は開発用コンピューターでは実行しない、その他のコード化されたテストも含まれます。
チーム エクスプローラーで、[ビルド] を開き、ビルド定義を追加または編集します。
[プロセス] ページで [自動テスト]、[テスト ソース]、[実行設定] の順に展開します。[実行設定の種類] を [コード カバレッジの有効化] に設定します。
複数のテスト ソース定義がある場合は、各定義に対してこの手順を繰り返します。
ただし、[実行設定の種類] というフィールドはありません。
[自動テスト] の下の [テスト アセンブリ] を選択し、行の末尾の省略記号 ([...]) ボタンを選択します。[テストの実行の追加と編集] ダイアログ ボックスで、[テスト ランナー] の下の [Visual Studio テスト ランナー] を選択します。
.png "コード カバレッジのビルド定義の設定")
ビルドの実行後、コード カバレッジの結果はテスト実行にアタッチされ、ビルドの概要に表示されます。
コマンド ラインでコード カバレッジを分析する
コマンド ラインからテストを実行するには、vstest.console.exe を使用します。コード カバレッジは、このユーティリティのオプションです。詳細については、「VSTest.Console.exe のコマンド ライン オプション」を参照してください。
Visual Studio 開発者コマンド プロンプトを起動します。
Windows の [スタート] メニューで [すべてのプログラム]、[Microsoft Visual Studio]、[Visual Studio ツール]、[開発者コマンド プロンプト] の順に選択します。
実行します。
vstest.console.exe MyTestAssembly.dll /EnableCodeCoverage
トラブルシューティング
コード カバレッジの結果が表示されない場合は、 「トラブルシューティング コード カバレッジ」を参照してください。