「アプリケーション開発におけるCppUnitの活用」

OS：Linux(CentOS 6.7)
開発環境：Xilinx SDK 2013.4
CppUnit：cppunit-1.12.1

以下のサイトからCppUnitダウンロードし、任意の場所に置きます。 https://sourceforge.net/projects/cppunit/cppunit/1.12.1/

CppUnitを解凍します。

[e-rt3@localhost ~]$ tar zxvf cppunit-1.12.1.tar.gz

解凍に成功すると「cppunit-1.12.1」フォルダが作成されます。

「cppunit-1.12.1」フォルダへ移動し、「./configure」スクリプトを実行し、Makefileを作成します。

[e-rt3@localhost ~]$ cd cppunit-1.12.1
[e-rt3@localhost cppunit-1.12.1]$ ./configure

「make」を実行し、CppUnitをビルドします。

[e-rt3@localhost cppunit-1.12.1]$ make

「make install」を実行し、CppUnitをインストールします。インストールはroot権限で実行します。

[root@localhost cppunit-1.12.1]# make install

インストールが完了すると、「/usr/local/lib」にCppUnitがインストールされます。

[root@localhost cppunit-1.12.1]# ls /usr/local/lib
libcppunit-1.12.so.1      libcppunit.a   libcppunit.so
libcppunit-1.12.so.1.0.0  libcppunit.la  pkgconfig

CppUnitに対するライブラリパスを設定するため、「/etc/lc.so.conf」に「/usr/local/lib」を追加します。
「/etc/lc.so.conf」の編集はroot権限が必要になります。

[root@localhost cppunit-1.12.1]# vi /etc/lc.so.conf

編集前

include ld.so.conf.d/*.conf

編集後

include ld.so.conf.d/*.conf
/usr/local/lib

編集が完了したら、「ldconfig」コマンドで反映します。

[root@localhost cppunit-1.12.1]# ldconfig

今回使用したXilinxのlibstdc++のバージョンは3.4.8ですが、CppUnitで必要なバージョンは3.4.9以降になります。そのため、Xilinx環境のlibstdc++を更新します。/usr/lib/にバージョン3.4.9のlibstdc++がありましたので、それをコピーします。ちなみに、バージョンはstringsコマンドで確認することができます。

[root@localhost lin]# cd /opt/Xilinx/SDK/2013.4/lib/lin/
[root@localhost lin]# cp /usr/lib/libstdc++.so.6 .
cp: `./libstdc++.so.6' を上書きしてもよろしいですか(yes/no)? yes

Xilinx環境のlibstdc++.so.6を変更したので、デバッグ情報をインストールします。

  [root@localhost lin]# yum --enablerepo='*-debug*' install
/usr/lib/debug/.build-id/b9/32867feec9b1a3abc385246cda4d55a8023f5e.debug

プロジェクトのリンカ設定にライブラリ(cppunitとdl)を登録します。
cppunitはCppUnitのライブラリです。
CppUnitではdlOpen等を使用するため、dlライブラリも必要です。

図2. プロジェクトのリンカ設定

以上でCppUnitの準備は完了です。

以下に、Calculateクラスのaddをテストする場合のテストコードを示します。

ターゲットクラス

// クラス宣言
class Calculate {
public:
  int add(int a, int b);
}

// 加算関数
int Calculate::add(int a, int b){
  return (a + b);
}

テストコード

#include 
#include 
#include 
#include 
#include 
#include 
#include 

class MyTest : public CPPUNIT_NS::TestFixture {
  CPPUNIT_TEST_SUITE(MyTest);	// テストケース開始の宣言
  CPPUNIT_TEST(test_add);		// テストケース
  CPPUNIT_TEST_SUITE_END();	// テストケース終了の宣言
public:
  virtual void setUp();		// テストケースの事前処理
  virtual void tearDown();	// テストケースの事後処理
protected:
  Calculate* mCalc;
  void test_add();
};
CPPUNIT_TEST_SUITE_REGISTRATION(MyTest);

// テストケースの事前処理
void MyTest::setUp(){
  mCalc = new Calculate();
}
// テストケースの事後処理
void MyTest::tearDown(){
  delete mCalc;
}
// add()のテストコード
void MyTest::test_add(){
  // add()に入力値1と2を与え、期待値3と比較する
  CPPUNIT_ASSERT_EQUAL(3, mCalc->add(1, 2));
}

// main()で登録されたテストをまとめて実行する
int main(int argc, char* argV[]){
  // イベント・マネージャとテスト・コントローラを生成する
  CPPUNIT_NS::TestResult controller;

  // テスト結果収集リスナをコントローラにアタッチする
  CPPUNIT_NS::TestResultCollector result;
  controller.addListener(&result);

  // 「.」で進行状況を出力するリスナをアタッチする
  CPPUNIT_NS::BriefTestProgressListener progress;
  controller.addListener(&progress);

  // テスト・ランナーにテスト群を与え、テストする
  CPPUNIT_NS::TestRunner runner;
  runner.addTest(CPPUNIT_NS::TestFactoryRegistry::getRegistry().makeTest());
  runner.run(controller);

  // テスト結果を標準出力に吐き出す
  CPPUNIT_NS::CompilerOutputteroutputter(&result,CPPUNIT_NS::stdCOut());
  outputter.write();

  return result.wasSuccessful() ? 0 : 1;
}

上記test_add()がテストコードの実装部分です。setUp()とtearDown()はテストケースの事前処理と事後処理になります。その他の説明はここでは省略します。

(1) CppUnitを導入するまでが大変

(2) 全てのテストケースに対応するテストコードを一つひとつ作成する必要がある

(3) 試験項目書とのマージが大変

(4) テスト失敗時に失敗理由がわからない

(5) テストの実行が楽