プリコンパイル・エージェント・モードを使用した Stingray プロジェクトの設定

注: プリコンパイル・エージェント・モードは,実行環境エージェント・モードが適切でない場合や使用できない場合にのみ,使用します。

このトピックの内容:

前提条件

  • グリッド・コントロールやタブ・コントロールなどいずれか 1 種類の Stingray コントロールしかアプリケーションに含まれていない場合であっても,Stingray Objective Grid と Stingray Objective Toolkit の両方をコンピュータにインストールする必要があります。

  • インストールするバージョンは,このアドインでサポートされているバージョンの組み合わせと一致している必要があります。サポートされているバージョンの組み合わせの一覧は,UFT One サポート・マトリクスを参照してください。

    注: Stingray Objective Grid および Stingray Objective Toolkit の必要なバージョンの組み合わせがない場合は,ソフトウェア・サポートにご相談ください。

  • Stingray アプリケーションが,以前のバージョンの Stingray Add-in のエージェント・ファイルを使用してコンパイルされている場合は,既存のエージェント・ファイルをプロジェクトから削除します。

    注意: 既存の Stingray Add-in エージェント・ファイルを最新のエージェント・ファイルに置き換えない場合は,ここでの手順を実行しないでください。UFT One Stingray Add-in を使用することはできますが,最新の機能は利用できなくなります。

先頭に戻る

StgAgentLib.h ファイルと StgAgentLib.lib ファイルのコピー

  1. StgAgentLib.h ヘッダ・ファイルを,<UFT One インストール・フォルダ>\bin\StingrayAgent\AgentLib\src\StgAgentLib.h から Visual C++ プロジェクト・ディレクトリにコピーします。(ヘッダ・ファイルを作業領域内のヘッダ・ファイルのリストに追加することもできます)。

  2. アプリケーションで使用している Stingray Objective Grid または Stingray Objective Toolkit のバージョンを確かめ,対応するサポート・ライブラリ・ファイル StgAgentLib.lib を検索します。

    たとえば,アプリケーションが Unicode でコンパイルされておらず,Objective Grid バージョン 9.03 および Objective Toolkit バージョン 8.03 を使用していて,MFC バージョン 7.1 にリンクされている場合は,以下の場所でライブラリ・ファイルを検索します。<UFT One インストール・フォルダ>\bin\StingrayAgent\AgentLib\bin\MFC71\OG903_OT803

    アプリケーションが MFC80 にリンクされていて,Unicode でコンパイルされており,Objective Grid バージョン 10.0 および Objective Toolkit バージョン 9.0 を使用する場合は,以下の場所でライブラリ・ファイルを検索します。<UFT One インストール・フォルダ>\bin\StingrayAgent\AgentLib\bin\MFC80\OG1000U_OT900U

    注: サポート・ライブラリ・ファイルではそれぞれ,Objective Grid と Objective Toolkit のバージョンの組み合わせが指定されています。アプリケーションでこれらのいずれか 1 つの Stingray ツールしか使用していない場合であっても,Objective Grid または Objective Toolkit のバージョンの組み合わせを選択する必要があります。サポートされている Stingray バージョンの組み合わせの一覧については,UFT One サポート・マトリクスを参照してください。

  3. StgAgentLib.lib サポート・ライブラリ・ファイルを Visual C++ プロジェクト・ディレクトリにコピーします。

先頭に戻る

Add #include "StgAgentLib.h" to a .cpp file

#include "StgAgentLib.h" ステートメントを,MainFrm.cpp などのいずれかの cpp ファイルに追加します。

先頭に戻る

ReleaseWRVC(); 関数呼び出しの追加

ReleaseWRVC(); 関数呼び出しを,アプリケーションの終了時に呼び出される CMainFrame::OnDestroy() などのいずれかの関数に挿入します。

注: この関数呼び出しの挿入によって,サポート・ライブラリ・コードに関連する必要なクリーンアップ処理がエージェントによって実行されます。

先頭に戻る

[プリコンパイル エージェント]オプションが選択されていることの確認

詳細については,Stingray Support Configuration Wizardを参照してください。

先頭に戻る

結果

アプリケーションの実行ファイルをビルドすると,追加したヘッダ・ファイルによって,自動的に StgAgentLib.lib サポート・ライブラリがアプリケーションに静的にリンクされ,実行セッション中にライブラリ・コードを自動的にアクティブにすることができます。

先頭に戻る