このセクションでは、C++test と統合する任意のソース管理システムに対するカスタム統合を 実装する方法について説明します (例えば、コードレビュー、スコープフィルター、および作成者 の検出。詳細については「ソース管理リポジトリとの接続」を参照してくださ い)。
「ソース管理リポジトリとの接続」で説明しているように、C++test は、SVN、 CVS、Subversion、ClearCase などの最も一般的なバージョン管理/ ソース管理システムのビルト インサポートを提供します。さらに C++test はオープンなソース管理 API を提供します。こ の API を使用すると、他のソース管理ツールを C++test に統合することができます。
このセクションの内容:
カスタムソース管理実装の追加
主要インターフェイス
すべての必要な実装をつないで作成するインターフェイスは com.parasoft.xtest.sourcecontrol.openapi.IVersionControlFactory です。
このファクトリは、次のインターフェイスのための固有の実装を提供します。
- com.parasoft.xtest.sourcecontrol.openapi.IRepositoryDetector
- com.parasoft.xtest.sourcecontrol.openapi.IVersionControl
- com.parasoft.xtest.sourcecontrol.openapi.IVersionControlHelper
実装とコンパイル
ソース管理 API とそれに関連するすべてのクラスは [INSTALL_DIR]\plugins\com.parasoft.xtest.libs/Parasoft/sourcecontrol.jar という jar ファ イルにあります。
コンパイルするために、以下の jar ファイルをクラスパスにさらに追加しなければならない場合があ ります。
- [INSTALL_DIR]\com.parasoft.xtest.libs/Parasoft/util.jar
- [INSTALL_DIR]\com.parasoft.xtest.libs/Parasoft/common.jar
- [INSTALL_DIR]\com.parasoft.xtest.libs/Parasoft/preference_api.jar
カスタム統合を実装するには、次の操作を行います。
- 任意の場所にプロジェクトを作成します。
- 必要な jar ファイルをプロジェクトのクラスパスに追加します。
- カスタムバージョン管理サポートの実装を開始します。IVersionControlFactory の実装から始め、必要なクラスを徐々に追加します。
デプロイメントと検証
実装が完了したら、次の操作を行います。
- 必要なすべてのクラスを含む 1 個の jar ファイルを作成します。jar ファイルの名前やパッ ケージの名前などについて特に規則はありません。
- Parasoft Test インストールディレクトリに jar ファイルをコピーし、Parasoft Test 製品 を再起動します。インストールディレクトリの場所は次のとおりです。
- Eclipse: [INSTALL_DIR]\plugins\com.parasoft.xtest.sourcecontrol.eclipse.core\ext
- Visual Studio: [INSTALL_DIR]\com.parasoft.xtest.libs.vstudio/ext
- 次の操作を行って実装を検証します。
- [Parasoft] メニューの [ 設定] をクリックし、[ ソース管理] を選択します。
- [DTPの設定を使用] チェックボックスがオフであることを確認します。
- ビルトインのバージョン管理システムに交じって、カスタム実装のチェックボック スがあることを確認します。
- カスタム実装のチェックボックスをオンにして [ 新規] ボタンをクリックします。 必要なプロパティを追加したら [ 適用] ボタンをクリックします。
- [ 設定] ウィンドウで [ スコープと作成者] を選択し、[ ソース管理 ( 変更作成者) を使ってスコープを計算] チェックボックスがオンであることを確認します。
- カスタム実装のバージョン管理システムによって制御されるファイルを開きます。 ファイルのソースコード中の任意の箇所を右クリックし、[行の作成者を表示] を選択します。有効なバージョン管理作成者情報が表示されるはずです。
サンプル実装
C++test は、オープンなソース管理 API のサンプル実装を提供します。次の場所に、圧縮され たパッケージがあります。
[INSTALL_DIR]\plugins\com.parasoft.xtest.sourcecontrol.eclipse.core\openapi\demo\
open_api_demo.zip ファイルを展開すると、次のディレクトリ構造が作成されるはずです。
- open_api_demo/demo.jar - コンパイルされた、Eclipse 用のソース管理デモの実装。
- open_api_demo/demo.dll - コンパイルされた、Visual Studio 2005 以降用のソース 管理デモの実装。
- open_api_demo/src/* - Open API デモ実装のソースコード。
- open_api_demo/local_repository/* - デモ用の Eclipse サンプルプロジェクト。
このデモは JDK 1.6.0_29 を使ってコンパイルされました。
前述のセクションで説明した手順を使ってデモをコンパイルおよびデプロイすることができます。
デモを実行するには、次の操作を行います。
- demo.jar ファイルをデプロイします。
- 任意の場所に local_repository を展開します。
- C++test を再起動します。
- Local Demo Repository プロジェクトをワークスペースにインポートします。
- [Parasoft] メニューの [ 設定] をクリックして [ ソース管理] を選択します。デモの実装の チェックボックスをオンにします。
- ファイルを開き、ファイルのソースコード中の任意の場所を右クリックして [ 行の作成者を 表示] を選択します。有効なバージョン管理作成者情報が表示されるはずです。