ビルド中のライブラリの位置および名前付けの制御

プリコンパイル済みのライブラリ、プリコンパイルされていないライブラリ、およびモデル参照ライブラリを生成する場合、コンフィギュレーションパラメーターを使用してライブラリの位置とライブラリ名を制御できます。これらのパラメーターは、モデルのビルド中に生成された makefile の値を制御します。

ツールチェーンアプローチを使用するビルドプロセスの場合、TargetPreCompLibLocation コンフィギュレーションパラメーターを使用して生成されたライブラリの位置を制御します。
テンプレート makefile アプローチを使用するビルドプロセスで、TargetPreCompLibLocation コンフィギュレーションパラメーターを使用して生成されたライブラリ名を制御し、TargetLibSuffix コンフィギュレーションパラメーターを使用して生成されたライブラリ名を制御します。

ライブラリ制御パラメーター

ライブラリ制御パラメーターを使用して、次を行います。

ブロックセットライブラリや Simulink^® Coder™ ブロックライブラリなどのプリコンパイル済みライブラリの位置を指定します。一般的に、ターゲットはこれらのライブラリのバージョンをクロスコンパイルし、ターゲット固有のフォルダーに置きます。
ライブラリファイル名に適用される接尾辞を制御します (たとえば、_target.a または _target.lib)。

ターゲットはシステムターゲットファイル (STF) 内のパラメーターを選択コールバックに設定することができます。以下に例を示します。

function mytarget_select_callback_handler(varargin)
    hDig=varargin{1};
    hSrc=varargin{2};
    slConfigUISetVal(hDig, hSrc, 'TargetPreCompLibLocation',...
    'c:\mytarget\precomplibs');
    slConfigUISetVal(hDig, hSrc, 'TargetLibSuffix',...
    '_target.library');

TMF は対応する拡張トークンをもっています。

    |>EXPAND_LIBRARY_LOCATION<|
    |>EXPAND_LIBRARY_SUFFIX<|

代わりに、関数 set_param への呼び出しを使用することもできます。以下に例を示します。

set_param(model,'TargetPreCompLibLocation',...
'c:\mytarget\precomplibs');

メモ

モデルが参照モデルを含んでいる場合は、make オプション USE_MDLREF_LIBPATHS を使用して、参照モデルの使用するライブラリをビルドフォルダーにコピーするかどうかを制御することができます。詳細については、モデル参照ライブラリの位置を参照してください。

ツールチェーンアプローチのライブラリファイルタイプの特定

モデルビルドのツールチェーンアプローチは、ライブラリファイル名 suffix および extension を選択するのに TargetLibSuffix コンフィギュレーションパラメーターの値は使用しません。

ツールチェーンアプローチでは、最終バイナリ名はツールチェーン定義のビルドツールの説明で提供される modelname、compilername および extension で構成されます。

model_compilername.extension

ツールチェーン定義のビルドツールの説明からスタティックライブラリファイル名の拡張子を識別できます。既定のツールチェーンのこの情報を入手するには、次の手順に従います。

既定のツールチェーン名を取得します。たとえば、次のコマンドを入力します。
```
tc_name = coder.make.getDefaultToolchain()
```
既定のツールチェーンハンドルを取得します。たとえば、次のコマンドを入力します。
```
tc = coder.make.getToolchainInfoFromRegistry(tc_name)
```
ツールチェーンオブジェクトへのハンドルを取得します。たとえば、次のコマンドを入力します。
```
tool_archiver = tc.getBuildTool('Archiver');
```
拡張子を取得します。たとえば、次のコマンドを入力します。
```
ext_archiver = tool_archiver.getFileExtension('Static Library');
```

メモ

TargetLibSuffix パラメーターを設定しない場合、テンプレート makefile およびツールチェーンアプローチは同じスタティックライブラリファイル名 extension を生成します。

プリコンパイル済みのライブラリの位置を指定

TargetPreCompLibLocation コンフィギュレーションパラメーターを使用して以下を実行します。

rtwmakecfg.m ファイル内で指定されたプリコンパイル済みのライブラリの位置をオーバーライド (詳細については、生成された makefile を rtwmakecfg.m API を使用してカスタマイズを参照)
製品ライブラリ (たとえば、DSP System Toolbox™ 製品) のターゲット固有のバージョンのプリコンパイルと配布

ブロックセットライブラリや Simulink Coder ブロックライブラリなどのプリコンパイル済みのライブラリの場合、rtwmakecfg.m 内で指定される位置は一般的にブロックセットや Simulink Coder 製品に固有の位置です。コードジェネレーターは、この場所にライブラリが存在することを前提にして、ビルド中にライブラリをリンクします。

カスタムのターゲットなどのアプリケーションによっては、rtwmakecfg.m 内で指定される位置ではなく、ターゲット固有か他の代わりの位置にプリコンパイル済みのライブラリを置くほうがいい場合があります。カスタムターゲットの場合、コードジェネレーターでは、ターゲット固有のクロスコンパイラでライブラリが作成され、そのライブラリがターゲット固有の場所に配置される必要があります。ターゲットでサポートされるライブラリは、ビルドプロセス中に使用できるように、ターゲット固有の位置にコンパイルして配置します。

その選択コールバック内で TargetPreCompLibLocation パラメーターを設定することができます。パラメーター用に指定するパスはライブラリの場所に対する完全修飾の絶対パスでなければなりません。相対パスはサポートされません。以下に例を示します。

slConfigUISetVal(hDlg, hSrc, 'TargetPreCompLibLocation',...
'c:\mytarget\precomplibs');

代わりに、関数 set_param を呼び出してパラメーターを設定することもできます。以下に例を示します。

set_param(model,'TargetPreCompLibLocation',...
'c:\mytarget\precomplibs');

makefile 生成中に、ビルドプロセスはトークンを rtwmakecfg.m ファイルからの場所で置き換えます。たとえば、rtwmakecfg.m ファイルのライブラリ名が 'rtwlib' の場合、テンプレート makefile ビルドアプローチはトークンを以下から拡張します。

LIBS += |>EXPAND_LIBRARY_LOCATION<|\|>EXPAND_LIBRARY_NAME<|\
_target.library

これを次のように変更します。

LIBS += c:\mytarget\precomplibs\rtwlib_target.library

既定の設定では、TargetPreCompLibLocation は空の文字ベクトルです。ビルドプロセスは、トークンを置換するために rtwmakecfg.m の場所を使用します。

モデル参照ライブラリの位置

ビルドプロセスは ../slprj/grt/sub/sub_rtwlib.lib のようなパスを MODELREF_LINK_LIBS に割り当てます。ビルドプロセスはリンク時にそのパスを使用してライブラリファイルへのアクセスを取得します。

接尾辞をライブラリファイル名に制御

モデルビルドのテンプレート makefile アプローチで、TargetLibSuffix コンフィギュレーションパラメーターを使用して、ライブラリ名に適用される接尾辞を制御します (たとえば、_target.lib や _target.a)。指定の接尾辞スキームはピリオド (.) を含まなければなりません。TargetLibSuffix を以下のライブラリに適用することができます。

rtwmakecfg.m API 内で指定されるようなターゲットが依存するライブラリ。TargetLibSuffix を使用して、rtwmakecfg API から設定されるプリコンパイル済みライブラリとプリコンパイルされていないライブラリの接尾辞を変更することができます。詳細については、生成された makefile を rtwmakecfg.m API を使用してカスタマイズを参照してください。
この例では、ターゲットはその選択コールバック内でパラメーターを設定することができます。以下に例を示します。
```
slConfigUISetVal(hDlg, hSrc, 'TargetLibSuffix',...
'_target.library');
```
代わりに、関数 set_param への呼び出しを使用することもできます。以下に例を示します。
```
set_param(model,'TargetLibSuffix','_target.library');
```
TMF から makefile への変換中に、ビルドプロセスはトークン |>EXPAND_LIBRARY_SUFFIX<| を指定の接尾辞に置き換えます。rtwmakecfg.m 内で指定されるライブラリ名が 'rtwlib' である場合は、TMF はそれを以下のように拡張します。
```
LIBS += |>EXPAND_LIBRARY_LOCATION<|\|>EXPAND_LIBRARY_NAME<|\
|>EXPAND_LIBRARY_SUFFIX<|
```
これを次のように変更します。
```
LIBS += c:\mytarget\precomplibs\rtwlib_target.library
```
既定の設定では、TargetLibSuffix は空の文字ベクトルに設定されています。この例では、ビルドプロセスはトークン |>EXPAND_LIBRARY_SUFFIX<| を空の文字ベクトルに置き換えます。
モデル参照を使用して作成されたモデルライブラリ。これらの例では、関連 makefile 変数は |>EXPAND_LIBRARY_SUFFIX<| トークンを必要としません。代わりに、ビルドプロセスは暗黙的に TargetLibSuffix を含みます。たとえば、refmodel1 と refmodel2 という名前の参照モデルをもつ topmodel という名前の最上位モデルの場合、最上位モデルの TMF は以下から拡張されます。
```
MODELLIB           = |>MODELLIB<|
MODELREF_LINK_LIBS = |>MODELREF_LINK_LIBS<|
```
これを次のように変更します。
```
MODELLIB           = topmodellib_target.library
MODELREF_LINK_LIBS = \
refmodel1_rtwlib_target.library refmodel2_rtwlib_target.library
```
既定の設定では、TargetLibSuffix パラメーターは空の文字ベクトルです。この例では、ビルドプロセスは、Windows^® ホスト上の .lib と UNIX^® ホスト上の .a のファイル拡張子を使用して、これらの 3 つのトークン用の既定の接尾辞を選択します｡モデル参照ライブラリの場合は、既定の接尾辞は _rtwlib も含みます。たとえば、Windows ホスト上では、拡張された makefile 値は以下のようになります。
```
MODELLIB           = topmodellib.lib
MODELREF_LINK_LIBS = refmodel1_rtwlib.lib refmodel2_rtwlib.lib
```