テストエクスプローラーを使用したネイティブコードの単体テスト

[アーティクル]
12/18/2014

Visual Studio では、C++ で記述されているアンマネージコードの単体テストできます。アンマネージコードは、ネイティブコードと呼ばれます。

次の手順は、起動する必要な情報が含まれています。後半のセクションでは、手順を詳しく説明するチュートリアルを紹介します。

アンマネージコード DLL 用の単体テストを作成するには

テストの他の Visual Studio でプロジェクトを作成するために [ネイティブテストプロジェクト] テンプレートを使用します。

テストプロジェクトはサンプルコードが含まれています。
DLL をテストにアクセスできるようにする:
- #include DLL の外部アクセス可能な関数の宣言を含む .h ファイル。
  
  .h ファイルは _declspec(dllimport)でマークされている関数宣言を含める必要があります。また、DEF ファイルを使ったメソッドをエクスポートできます。詳細については、「Importing and Exporting from a DLL」を参照してください。
  
  単体テストはテスト対象の DLL からエクスポートされる関数にのみアクセスできます。
- テストプロジェクトの参照が DLL のプロジェクトを追加する:
  
  テストプロジェクトの [プロパティ] で、[共通プロパティ]、[Framework と参照] を展開し、[参照の追加] をクリックします。
テストプロジェクトで、テストクラスとテストメソッドをテストマクロを使用して作成し、そのクラスを次のようにアサートする:
```
#include "stdafx.h"
#include <CppUnitTest.h>
#include "..\MyProjectUnderTest\MyCodeUnderTest.h"
using namespace Microsoft::VisualStudio::CppUnitTestFramework;
TEST_CLASS(TestClassName)
{
public:
  TEST_METHOD(TestMethodName)
  {
    // Run a function under test here.
    Assert::AreEqual(expectedValue, actualValue, L"message", LINE_INFO());
  }
}
```
- Assert はテストの結果を確認するために使用できるさまざまな静的関数が含まれています。
- LINE_INFO() パラメーターは省略できます。 PDB ファイルがない場合は、テストランナーのエラーの位置を特定できるようになります。
- また、テストの設定、およびクリーンアップメソッドを記述できます。詳細については、TEST_METHOD マクロの定義を開き、CppUnitTest.h のコメントを読み取ります。
- テストクラスを入れ子にすることはできません。
テストを実行するためにテストエクスプローラーを使用する:
1. [表示] メニューで、[その他のウィンドウ]、[テストエクスプローラー] の順にクリックします。
2. Visual Studio ソリューションをビルドします。
3. テストエクスプローラーで [すべて実行] をクリックします。
4. テストをテストエクスプローラーで詳しく調査するには:
  1. エラーメッセージおよびスタックトレースなどの詳細を参照するには、テスト名を選択します。
  2. エラーの場所またはテストコードに進むにテスト名 (たとえば) をダブルクリックして開きます。
  3. テストのショートカットメニューで、デバッガーのテストを実行するに [選択されたテストのデバッグ] をクリックします。

チュートリアル: テストエクスプローラーによるアンマネージ DLL の開発

独自の DLL を開発するには、このチュートリアルを調整できます。主な手順は次のとおりです。:

ネイティブテストプロジェクトを作成します。テストは、DLL とは別のプロジェクトで開発すると作成されます。
DLL のプロジェクトを作成します。このチュートリアルでは、新しい DLL を作成しても、既存の DLL をテストする手順は似ています。
DLL 関数をテストに参照できるようにします。
テストを繰り返し増やしてください。これは、コードの開発とテストでガイド「Red」緑リファクタリングのサイクルをお勧めします。
失敗したテストのデバッグ。デバッグモードでテストできます。
テストを変えずリファクタリング。リファクタリングは外部動作を変更せずにコードの構造の改良を意味します。コードのパフォーマンス、拡張、または読みやすさが向上するようにできます。目的の動作を変更することはないため、コードのリファクタリングの変更を行っている最中にテストは変更されません。テストはリファクタリング中、バグがないことを確認します。したがって、テストがない場合は、よりも多くの自信をもつこのような変更を加えることができます。
カバレッジを確認します。単体テストでは、コードの多くを実行する場合に便利です。コードのどの部分をテストで使用されたかを検出できます。
外部リソースから分離単位。通常、DLL は、そのほかの DLL など、データベースを開発している、またはリモートシステムサブシステムの他のコンポーネントに依存しています。依存関係の分離の各単位をテストする場合に便利です。外部コンポーネントは、テストの実行速度を設定できます。開発時に、他のコンポーネントが不完全である可能性があります。

ネイティブ単体テストプロジェクトを作成する

[ファイル] メニューで、[新規]、[プロジェクト] をクリックします。

ダイアログボックスで、[インストール済み]、[テンプレート]、[Visual C++]、[テスト] を展開します。

[ネイティブテストプロジェクト] テンプレートを選択します。

このチュートリアルでは、テストプロジェクトが NativeRooterTestという名前です。
新しいプロジェクトでは、unittest1.cppをチェックします。

次の点に注意してください。
- 各テストは TEST_METHOD(YourTestName){...}を使用して定義されます。
  
  従来の関数シグネチャを記述する必要はありません。シグネチャは TEST_METHOD マクロによって作成されます。マクロは、void インスタンスの関数を生成します。また、静的関数は、テストメソッドに関する情報を生成します。この情報は、テストエクスプローラーにメソッドを探すことができます。
- テストメソッドがクラスに TEST_CLASS(YourClassName){...}を使用してグループ化されます。
  
  テストの実行時、各テストクラスのインスタンスが作成されます。テストメソッドは、不定の順序で呼び出されます。各モジュール、クラス、またはメソッドの前後に呼び出される特殊なメソッドを定義できます。詳細については、「組織 C++ テスト」を参照してください。
テストエクスプローラーでテストを実行できることを確認する:
1. テストコードを挿入する:
```
TEST_METHOD(TestMethod1)
{
Assert::AreEqual(1,1);
}
```
  Assert クラスがテストメソッドの結果を確認するために使用できるさまざまな静的メソッドを提供することに注意してください。
2. [テスト] メニューで、[すべてのテスト(A)][実行 ] をクリックします。
  
  テストのビルドと実行。
  
  テストエクスプローラーが表示されます。
  
  テストは [成功したテスト数] の下に表示されます。

アンマネージ DLL プロジェクトを作成する

[Win32 プロジェクト] のテンプレートを使用して [Visual C++] のプロジェクトを作成します。

このチュートリアルでは、プロジェクトは RootFinderという名前です。
Win32 アプリケーションウィザードの [シンボルのエクスポート][DLL] を選択します。

[シンボルのエクスポート] オプションがエクスポートしたメソッドを宣言するために使用できる便利なマクロを生成します。
プリンシパル .h ファイルのエクスポート関数を宣言する:

宣言子 __declspec(dllexport) はクラスのパブリックメンバーとプロテクトメンバーを DLL の外側に表示される。詳細については、「C++ クラスでの dllimport と dllexport の使用」を参照してください。

プリンシパル .cpp ファイルで、関数の最小の本体を追加する:

// Find the square root of a number.
double CRootFinder::SquareRoot(double v)
{
  return 0.0;
}

DLL プロジェクトにテストプロジェクトを結合する

テストプロジェクトのプロジェクト参照に DLL のプロジェクトを追加する:
1. テストプロジェクトのプロパティを開き、[Framework と参照][共通プロパティ] をクリックします。
2. [新しい参照の追加] をクリックします。
  
  [参照の追加] ダイアログボックスで、DLL のプロジェクトを選択し、[追加] をクリックします。
主な単体テスト .cpp ファイルで、DLL コードの .h ファイルを格納する:
```
#include "..\RootFinder\RootFinder.h"
```

エクスポート関数を使用する基本的なテストを追加する:

TEST_METHOD(BasicTest)
{
CRootFinder rooter;
Assert::AreEqual(
// Expected value:
0.0, 
// Actual value:
rooter.SquareRoot(0.0), 
// Tolerance:
0.01,
// Message:
L"Basic test failed",
// Line number - used if there is no PDB file:
LINE_INFO());
}

ソリューションをビルドします。

新しいテストがテストエクスプローラーに表示されます。
テストエクスプローラーで [すべて実行] をクリックします。

コードプロジェクトの関数を実行するテストを実行できることをテストおよびコードプロジェクトと検証した設定されます。ここで実際のテスト、およびコードの記述を開始できます。

テストを繰り返し増やして成功させる

新しいテストの追加:
```
TEST_METHOD(RangeTest)
{
  CRootFinder rooter;
  for (double v = 1e-6; v < 1e6; v = v * 3.2)
  {
    double actual = rooter.SquareRoot(v*v);
    Assert::AreEqual(v, actual, v/1000);
  }
}
```
ヒント

これは、合格したテストを変更しないことをお勧めします。代わりに、新しいテストを追加して、コードをテスト成功更新し、別のテストなど) を追加します。

ユーザーが要件を変更する場合は、正しいテストを無効にしてください。新しいテストを記述して同じインクリメンタル方法で、一度に一つずつ表示します。
次に、テストエクスプローラーでソリューションを選択し、[すべて実行] をクリックしますビルドします。

新しいテストが失敗します。

ヒント

これを記述した直後に各テストが失敗することを検証します。これは、失敗してテストを記述する簡単な誤りを防ぐことができます。

新しいテスト成功ようにテスト対象コードを拡張する:

#include <math.h>
...
double CRootFinder::SquareRoot(double v)
{
  double result = v;
  double diff = v;
  while (diff > result/1000)
  {
    double oldResult = result;
    result = result - (result*result - v)/(2*result);
    diff = abs (oldResult - result);
  }
  return result;
}

次に、テストエクスプローラーで、ソリューションを [すべて実行] をクリックしますビルドします。

両方のテストが成功します。

ヒント

テストを一つずつ追加してコードを開発します。すべてのテストを反復処理するたびに成功することを確認します。

失敗したテストをデバッグする

別のテストを追加する:

#include <stdexcept>
...
// Verify that negative inputs throw an exception.
TEST_METHOD(NegativeRangeTest)
{
  wchar_t message[200];
  CRootFinder rooter;
  for (double v = -0.1; v > -3.0; v = v - 0.5)
  {
    try 
    {
      // Should raise an exception:
      double result = rooter.SquareRoot(v);

      _swprintf(message, L"No exception for input %g", v);
      Assert::Fail(message, LINE_INFO());
    }
    catch (std::out_of_range ex)
    {
      continue; // Correct exception.
    }
    catch (...)
    {
      _swprintf(message, L"Incorrect exception for %g", v);
      Assert::Fail(message, LINE_INFO());
    }
  }
}

ソリューションをビルドし、[すべて実行] をクリックします。
(またはダブルクリック) 失敗したテストを開きます。

アサーションが強調表示されます。エラーメッセージは、テストエクスプローラーの詳細ペインに表示されます。
テストが失敗したかを参照するには、関数をステップ実行する:
1. SquareRoot 関数の先頭にブレークポイントを設定します。
2. 失敗したテストのショートカットメニューで、[選択したテストのデバッグ(D)] をクリックします。
  
  ブレークポイントで実行が停止したときに、コードをステップ実行します。

配置する関数にコードを挿入する:

#include <stdexcept>
...
double CRootFinder::SquareRoot(double v)
{
    // Validate parameter:
    if (v < 0.0) 
    {
      throw std::out_of_range("Can't do square roots of negatives");
    }

すべてのテストで渡します。

テストを変更せずにコードをリファクタリングする

SquareRoot 関数を中央の計算を簡略化する:

// old code:
//   result = result - (result*result - v)/(2*result);
// new code:
     result = (result + v/result)/2.0;

ソリューションをビルドし、エラーが生じないように、[すべて実行] をクリックします。

ヒント

コードを変更するときにバグが生じないこと適切なセットの単体テストは全体を示します。

他の変更とは別にリファクタリングを保持します。

次のステップ

分離ほとんどの DLL はデータベースなどの他のサブシステムやそのほかの DLL に依存します。これらのコンポーネントは、同時に作成されます。他のコンポーネントがまだ利用できないで単体テストを実行するように、またはサンプルに置き換える必要があります
**ビルド確認テスト。**指定した間隔でチームのビルドサーバーで実行するテストを指定できます。これは、一部のチームメンバーの作業を統合するときにバグがもたらされないことを確認します。
**チェックインテスト。**あるテストがソース管理に各チームメンバーのチェックコードの前に実行されることを必須とすることができます。通常、ビルド確認テストの完全なセットのサブセットです。

また、コードカバレッジの最小を義務付けていることができます。

参照

処理手順

チュートリアル: ダイナミックリンクライブラリの作成と使用 (C++)

その他の技術情報

マネージコードとアンマネージコードとの相互運用性の概要

ネイティブコードのデバッグ

Importing and Exporting from a DLL

次の方法で共有

テストエクスプローラーを使用したネイティブコードの単体テスト

アンマネージコード DLL 用の単体テストを作成するには

チュートリアル: テストエクスプローラーによるアンマネージ DLL の開発

ネイティブ単体テストプロジェクトを作成する

アンマネージ DLL プロジェクトを作成する

DLL プロジェクトにテストプロジェクトを結合する

テストを繰り返し増やして成功させる

失敗したテストをデバッグする

テストを変更せずにコードをリファクタリングする

次のステップ

参照

処理手順

その他の技術情報

その他のリソース

次の方法で共有

テスト エクスプローラーを使用したネイティブ コードの単体テスト

アンマネージ コード DLL 用の単体テストを作成するには

チュートリアル: テスト エクスプローラーによるアンマネージ DLL の開発

ネイティブ単体テスト プロジェクトを作成する

アンマネージ DLL プロジェクトを作成する

DLL プロジェクトにテスト プロジェクトを結合する

テストを繰り返し増やして成功させる

失敗したテストをデバッグする

テストを変更せずにコードをリファクタリングする

次のステップ

参照

処理手順

その他の技術情報

その他のリソース

テストエクスプローラーを使用したネイティブコードの単体テスト

アンマネージコード DLL 用の単体テストを作成するには

チュートリアル: テストエクスプローラーによるアンマネージ DLL の開発

ネイティブ単体テストプロジェクトを作成する

DLL プロジェクトにテストプロジェクトを結合する