＜Webinarのサンプルを開く＞　＜モデル表示画面、左にフィーチャー、右にファミリーモデルを配置＞

Transcription

1 デモ概説書 1. 目的 pure:variants の使用準備 プロジェクトの作成 モデルの表示と製品バリアントの生成 フィーチャーとファミリーの関連付け ソースコード内のフラグの管理 メイクファイルに受け渡すファイル名の処理... 17

2 1. 目的この資料では 気象監視システムのサンプルを用いて pure::variants のモデリング環境とバライアビリティー / バリアント管理機能の使い方を説明しています pure::variants を用いて製品ファミリーの バリアントとバライアビリティーを分類し 管理することで 体系的に資産を再利用して 効率良く開発し メンテナンスができるようになります また弊社 pure::variants 製品情報サイトにある以下の動画デモは 同じサンプルを用いていますので ご覧いただくことで 評価を効率的に行っていただけるかと思います pure::variants 製品情報 基本操作と概念 フラグの管理と make ファイル 2. pure:variants の準備 1 Eclipse の日本語化について 言語パックEclipseのアップデートマネージャー(Help Install New Software) からインストールできます 以下のURLをUpdate Siteとして登録して接続し 日本語化言語パックを選択してインストールしてください インストール終了後 Eclipse を再起動すると Eclipse の各種メニューが日本語化されます ( ただし pure::variants やいくつかのメニューは日本語化されません ) 1

3 2 プロジェクトのコピー purevariants_demo.zip を解凍し WSC++ と Webinar Finished ディレクトリを C:\[ ワークスペースフォルダの場所 ] 以下にコピーします zip ファイルは からダウンロードして下さい 3 コンパイラ環境のインストール Windows 上で実行可能なフリーの GNU C コンパイラ環境である MinGW とそれを実行するためのコンソール環境である Msys をインストールしてください これらのプログラムは SourceForge の からダウンロード出来ます Automated MinGW Installer の MinGW-x.x.x MSYS Base SYSTEM->Current Release の MSYS-x.x.x.exe x.x.x は共にバージョン番号をダウンロードしてください インストールに関する情報は を ご参照ください 3. プロジェクトの作成通常 プロジェクトは新規に作成しますが ここでは 既存のプロジェクトをインポートする方法をとります 以下の手順で プロジェクトをインポートできます 1 ファイル->インポートメニューで インポートウィザードを表示させます Variant Projects 表示のコンテキストメニューでも表示可能です 2 一般 -> 既存プロジェクトをワークスペースへ を選択し 次へ ボタンをクリックします 2

4 3 ルート ディレクトリーの選択 に C:\[ ワークスペースフォルダの場所 ]\ を設定します 参照 ボタンでファイル選択ダイアログによる指定が可能です 4 プロジェクトに WSC++ と Webinar Finished が表示され チェックボックがスチェックされているこ とを確認し 終了ボタンをクリックします 3

5 4. モデルの表示と製品バリアントの生成 1 WebinarFinished プロジェクトの WebinarFeatures.xfm をダブルクリックすることで フィーチャーモデルが表示されます このモデルには 製品ファミリーの各機能や それらの関係が階層構造で登録されています 各モデルエレメントの左の + マークをクリックする事で下位の階層を表示できます このモデルでは 温度を測定する Temperature 機能と 風速を測定する Wind Speed 機能があり それぞれが複数の表示単位を持つことが分かります 4

6 2 同様に WebinarFamily.ccfm をダブルクリックすることで ファミリーモデルが表示されます このモデルは 製品ファミリーのクラス オブジェクト 関数 変数 ドキュメントなどのコンポーネントで構成され これらの相互接続や制限 条件なども含みます フィーチャーモデル同様階層構造になっており 下位の階層を表示させることが可能です ここには 実際のソースコードやメイクファイルなどへのリンクが登録されていることが分かります これら2つのモデル間にはリンクがはられており 製品ファミリーの変動要素が一貫して管理されています 5

7 3 Webinar Finished プロジェクトの WebinarConfig コンフィグレーションスペースに バリアントディスクリプションモデル (VDM) が登録されています その中の WebinarConfig.vdm をダブルクリックしてモデルを開きます このモデルで単一製品のフィーチャーの組み合わせを選択できます ここでは 摂氏の温度表示とノットの風速表示が選択されています 4 Transform Model ボタンをクリックする事で 選択されたフィーチャーに対応した ファミリーモデ ルのコンポーネントが抽出されます この例では C:\[ ワークスペースフォルダの場所 ]\Webinar Finished\Output\WSC++ ディレクトリ以下に ソースファイルとメイクファイルが生成されます 6

8 出力先にファイルが存在する場合は 上書きの確認ダイアログが表示されます 通常 はい で先 へ進めます ファイル生成の終了ダイアログです OK ボタンで先へ進めます 5 生成されたソースファイルを実際にビルドします スタート->すべてのプログラム->MinGW-> MSYS->msys を実行し MinGW の実行コンソールを開きます 6 コンソールで上記のソースディレクトリに移動し make を実行することで製品 (ws.exe) がビルドされます ws.exe を実行することで 温度と風力が計測されるアプリの動作が確認できます CTRL+C でアプリケーションを終了します 7

9 5. フィーチャーとファミリーの関連付け 1 フィーチャーモデルの Temperature を選択すると 右端の Relation 表示に関連付けられたコンポーネントが表示されます ここでは 子フィーチャーとして Cと Fが 親フィーチャーとして WebinarFeatures が設定されていることが分かります また ps:classtemperature ファミリーエレメントが このフィーチャーを参照していることも分かります 2 このフィーチャーのコンテキストメニューからプロパティを選択することで 詳細な設定を確認することが出来ます Cのプロパティを表示させて Relations タブを選択すると American/British フィーチャーに対して ps:confilicts リレーションが設定されています これら2つのフィーチャーが同時に選択できない制約を表すリレーション設定です 8

10 3 フィーチャーモデルの下の Graph タブで グラフィカルに表示することも可能です 4 ファミリー モデルには 資産コードとして 気圧計のアプリ (psclass:pressure) が存在していま すが フィーチャーモデル側には まだ登録されていません そこで これをフィーチャーモデルに 登録します 9

11 5 WebinarFeature のコンテキストメニューで New->Feature を選択して ウィザードを表示させます 6 uniquename として AirPressure VisibleName として気圧計を設定します VariationType には 必ず選択の Mandatory 選択可能の Optional どれか1つだけ選択の Alternative 1つ以上を必ず選択の Or がありますが ここでは 温度や風速と同様に 1つ以上を必ず選択の OR を設定します また DefaultSelected のチェックも設定しておきます 終了ボタンでウィザードを閉じます 10

12 7 追加したフィーチャーと ファミリーモデル上のコンポーネント間のリンクをはります ファミリー モデルの Pressure のコンテキストメニューで Properties を選択します プロパティダイアログで Restrictions タブを選んで Restriction の 1 列目をクリックし 右端のアイコンをクリックします 8 テキスト領域に文字が設定されていればそれを消去し CTRL+SPACE を実行します 設定可能な項目 のリストが表示されますので 先程フィーチャーモデルに登録した 気圧計をダブルクリックします OK ボタンで 2 つのダイアログを閉じます 11

13 9 VDM を表示すると新たに気圧計が選択できるようになっています ここで下図のように各フィーチャ ーを設定し Transform を実行することで 新たな製品のソースコードが生成されます 気圧計選択時にエラーが発生する場合は Check Model を実行後 再度設定してください 12

14 10 MSYS コンソールで再度ビルドを行い プログラムを実行することで 気圧の計測が追加されてい ることが確認できます 6. ソースコード内のフラグの管理 1 ファミリーモデルで管理されている資産コードは このサンプルの場合は Variant Project ウィンドウの WSC++ プロジェクトの配下にあります 例えば 温度計のソースは Sensors -> Temperature.cc として登録されていて Open with ->テキストエディタでソースを表示出来ます 2 このコードは #IFDEF で FAHRENHEIT フラグを参照して 摂氏 華氏の表示を切り替えています このような場合には フラグ単位でバライアビリティを管理することができます 13

15 3 ファミリーモデルの WSC++->ps:variable:CPPFLAGS_TEMP のコンテキストメニューで Tree Layout->Show All を選択すると 設定の詳細が表示されるようになります 4 このように psvariable:cppflags_temp 変数を定義して FAHRENHEIT フラグを参照させるためのコンパイラオプション Value = -D FAHRENHEIT を設定しています 5 14

16 6 このコンパイラオプションは ps:makefile: config.mk の中で 変数 CPPFLAGS を介して config.mk に代入されるように設定されています それらの設定の結果として makefile 内でコンパイラオプ ションとして指定されます 7 ps:variable:cppflags_temp をダブルクリックすることでプロパティを表示することができ Restrictions タブをクリックする事で TemperatureF フィーチャーが選択された時のみ有効になる様に リストリクションが設定されていることが分かります 15

17 8 これは ps:variable:cppflags_temp の TemperatureF をダブルクリックすると Relations に F フ ィーチャーが表示されることでも確認できます 16

18 9 実際に作成された Config.mk は Variant Projects の Webinar Finished->Output->WSC++->config.mk 10 のコンテキストメニューで Open With-> テキストエディタを選択することで 表示できます 7. メイクファイルに受け渡すファイル名の処理 1 また pure::variants は VDM を変換して生成したソースファイルから コンパイルするべきファイルリストを抽出し Makefile へ受け渡すこともできます 2 Transformation の設定は Configuration Space を使って行います Variant Projects で Webinar Finished プロジェクト->WebinarConfig のコンテキストメニューで プロパティを選択します 17

19 3 プロパティダイアログで Configuration Space を選択し Input-Output タブを選択します ここでは Input としてソースファイルのあるディレクトリ Output として VDM を変換して生成されるファイルの出力先が指定されています Transform Model を実行すると この設定に基づいて 必要なファイルがコピーされます 4 Transformation Configuration タブをクリックすると Transform Model 実行時に行う動作の規定が確認できます Convert to transformer action list でコピーするファイルのリストを作成し Execute transformer action list でそれらのファイルを実際にコピーし Makefile でファイルリストを基に Makefile を作成しています 5 Makefile を選択し Edit ボタンをクリックし 表示されるダイアログで 次へ ボタンをクリックす 18

20 ることで Makefile 作成の詳細な設定が確認できます Makefile のファイル名は out のパラメー タで config.mk と指定されており 先程 Input-Output の Output で指定したディレクトリに作成 されます ここでは 設定が目的ではないので キャンセルをクリックします 6 Variant Projects の Webinar Finished プロジェクト->Output->WSC++->Makefile のコンテキストメニューで Open With-> テキストエディタを選択することで 生成された Makefile を確認できます このファイル内で 以下の様に config.mk がインクルードされており コンパイラにソースファイルのリストが引き渡されるようになっています 富士設備工業株式会社電子機器事業部 大阪府堺市北区長曽根町 Tel: