主要内容

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

ビルド設定の構成

ビルドタイプの指定

ビルドタイプ

MATLAB®编码器™は以下の出力タイプを生成できます。

  • 墨西哥人関数

  • スタンドアロン C/C++コード

  • スタンドアロン C/C++コードおよびスタティック ライブラリへのコンパイル

  • スタンドアロンC / c++コードおよびダイナミックリンクライブラリへのコンパイル

  • スタンドアロンC / c++コードおよび実行可能ファイルへのコンパイル

    メモ

    実行可能ファイルを生成する場合は,C / c++実行可能ファイルの主要関数の指定で説明されているように,主要関数を含むC / c++ファイルを指定しなければなりません。

ファイルが生成される場所

既定では,MATLAB编码器は出力タイプに基づいた出力フォルダーにファイルを生成します。詳細は,生成ファイルと場所を参照してください。

メモ

MATLAB编码器は,同じコードまたはプロジェクトに対して同じタイプの出力を生成するたびに,前回ビルドしたファイルを削除します。新しいビルドでファイルが書き換えられないようにする場合は,ファイルを別の場所にコピーしてからビルドを開始します。

MATLAB编码员アプリを使用したビルドタイプの指定

  1. [生成]ダイアログ ボックスを開くために、[コード生成)ページの[生成]矢印をクリックします。

  2. [ビルドタイプ]を次のいずれかに設定します。

    • ソースコード

    • 墨西哥人

    • スタティックライブラリ

    • ダイナミック ライブラリ

    • 実行可能ファイル

[ソース コード]を選択すると,MATLAB编码器は使コマンドを実行せず,コンパイルされたオブジェクトコードも生成しません。MATLABコードの変更と C/C++ コードの生成を繰り返して生成されたコードを検査するときに、このオプションを指定すると時間を短縮できます。このオプションは[コード生成のみ]ボックスを選択して[スタティック ライブラリ]を選択するのと同等です。

コード生成では,墨西哥人関数に対して,他のビルドタイプで使用されるものとは異なる一連の構成パラメーターが使用されます。出力タイプを(墨西哥人関数)[ソース][スタティック ライブラリ][ダイナミック ライブラリ]または(実行可能ファイル]の間で切り替える場合は、これらの設定を確認してください。

特定の構成パラメーターは,墨西哥人コードとスタンドアロンコードの両方の生成に関連します。出力タイプが(墨西哥人関数)のときに,このようなパラメーターのいずれかを有効にし,その同じ設定をC / c++コードの生成に使用する場合,[C/C++スタティック ライブラリ][C/C++ダイナミック ライブラリ]および[C/C++実行ファイル]に対して再度有効にしなければなりません。

コマンドラインでのビルドタイプの指定

-配置オプションを使用して编码基因を呼び出します。たとえば、入力パラメーターを取らない基本関数喷火があるとします。以下の表は、喷火のコンパイル時に異なる出力タイプを指定する方法を示しています。基本関数が入力パラメーターをもっている場合は、それらの入力を指定しなければなりません。詳細は、エントリポイント関数の入力のプロパティの指定を参照してください。

メモ

Cが、MATLAB编码器でコードを生成する際の既定の言語です。c++コードを生成するには,コード生成用言語の指定を参照してください。

生成するもの 使用するコマンド
墨西哥関数 (既定のコード生成オプションを使用)

codegen foo

墨西哥関数 (コード生成オプションを指定)

cfg = coder.config(墨西哥人);%设置配置参数,例如,%启用代码生成报告cfg.GenerateReport=true;%调用codegen,传递配置% object codegen -config cfg

スタンドアロン C/C++コードおよびライブラリへのコンパイル (既定のコード生成オプションを使用)
codegen-config:libfoo
スタンドアロンC / c++コードおよびライブラリへのコンパイル(コード生成オプションを指定)

cfg=coder.config('lib');%设置配置参数,例如,%启用代码生成报告cfg.GenerateReport=true;%调用codegen,传递配置%object codegen-config cfg foo

スタンドアロン C/C++コードおよび実行可能ファイルへのコンパイル (既定のコード生成オプションを使用し、コマンド ラインでmain.cファイルを指定)

codegen-config:exe main.cfoo

メモ

C / c++実行可能ファイルを生成するには,主要関数を指定しなければなりません。C / c++実行可能ファイルの主要関数の指定を参照してください。

スタンドアロン C/C++コードおよび実行可能ファイルへのコンパイル (コード生成オプションを指定)

cfg = coder.config (exe);%设置配置参数,如“%指定主文件cfg”。CustomSource = ' c ';cfg。CustomInclude = 'c:\myfiles'; codegen -config cfg foo

メモ

C / c++実行可能ファイルを生成するには,主要関数を指定しなければなりません。C / c++実行可能ファイルの主要関数の指定を参照してください。

コード生成用言語の指定

MATLAB编码器は Cまたは C++のライブラリや実行可能ファイルを生成できます。Cが既定の言語です。[プロジェクトの設定] ダイアログ ボックスやコマンド ラインで、言語を明示的に指定できます。

MATLAB编码员アプリを使用した言語の指定

  1. [生成]ダイアログ ボックスを開くために、[コード生成)ページの[生成]矢印をクリックします。

  2. [言語][丙]または[C++]に設定します。

    メモ

    c++を指定すると,MATLAB编码器Cコードを.cppファイルにラップします。c++コンパイラを使用し,外部のc++アプリケーションとインターフェイスを取ることができます。MATLAB编码器c++クラスを生成しません。

コマンド ライン インターフェイスを使用した言語の指定

  1. ターゲット言語に適したコンパイラを選択します。

  2. コード生成の構成オブジェクトを作成します。たとえば,ライブラリの場合は以下のとおりです。

    cfg = coder.config(“自由”);

  3. TargetLangプロパティを“C”または“C++”に設定します。以下に例を示します。

    cfg。TargetLang =“c++”;

    メモ

    c++を指定すると,MATLAB编码器Cコードを.cppファイルにラップします。これでc++コンパイラを使用し,外部のc++アプリケーションとインターフェイスで接続できるようになります。MATLAB编码器c++クラスを生成しません。

参考

出力ファイル名の指定

MATLAB编码员アプリを使用した出力ファイル名の指定

  1. [生成]ダイアログ ボックスを開くために、[コード生成)ページの[生成]矢印をクリックします。

  2. (出力ファイル名)フィールドにファイル名を入力します。

メモ

ファイル名にスペースを含めないでください。

既定では,最初のエントリポイントであるMATLABファイルの名前がfcn1の場合,出力ファイル名は次のようになります。

  • fcn1(C / c++ライブラリおよび実行可能ファイル用)。

  • fcn1_mex(墨西哥)関数用)。

既定では,MATLAB编码器はフォルダー项目文件夹/ codegen /目标/ fcn1にファイルを生成します。

  • 项目文件夹は現在のプロジェクトフォルダーです。

  • 目标は次のようになります。

    • 墨西哥人(墨西哥)関数用)

    • 解放党(C/C++スタティック ライブラリ用)

    • dll(C / c++ダイナミックライブラリ用)

    • exe(C/C++実行可能ファイル用)

コマンド ラインを使用する場合

関数编码基因- oオプションを使用します。

出力ファイルの場所の指定

MATLAB编码员アプリを使用した出力ファイルの場所の指定

出力ファイルの場所に次を含めることはできません。

  • スペース (スペースを使用すると、オペレーティング システムの構成によっては、コード生成に失敗する可能性があります)

  • タブ

  • 非 7.ビット ASCII码文字 (日本語など)

  1. [生成]ダイアログ ボックスを開くために、[コード生成)ページの[生成]矢印をクリックします。

  2. (要件に応じて)[ビルドタイプ][ソース コード][スタティック ライブラリ][ダイナミック ライブラリ]または(実行可能ファイル]に設定します。

  3. [詳細設定]をクリックします。

  4. [パス]タブをクリックします。

    [ビルド フォルダー]フィールドの既定の設定は[プロジェクトフォルダーのサブフォルダー]です。既定では、MATLAB编码器はフォルダー项目文件夹/ codegen /目标/ fcn1にファイルを生成します。

    • fcn1はアルファベット順で最初のエントリポイントファイルの名前です。

    • 目标は次のようになります。

      • 墨西哥人(墨西哥)関数用)

      • 解放党(C/C++スタティック ライブラリ用)

      • dll(C / c++ダイナミックリンクライブラリ用)

      • exe(C/C++実行可能ファイル用)

  5. 出力場所を変更するには、以下のいずれかを行います。

    • [ビルド フォルダー][MATLABの現在の作業フォルダーのサブフォルダー]に設定します。

      MATLAB编码器はファイルをMATLAB_working_folder/ codegen /目标/ fcn1フォルダーに生成します。

    • [ビルド フォルダー](指定したフォルダー]に設定します。[ビルドフォルダー名)フィールドにフォルダーのパスを指定します。

コマンド ラインを使用する場合

関数编码基因- dオプションを使用します。

パラメーターの指定方法

作業対象 使用 詳細
MATLAB编码器アプリ [プロジェクトの設定]ダイアログボックス MATLAB编码器アプリを使用したビルド構成パラメーターの指定
コマンド ラインの编码基因(少数のパラメーターを指定) 構成オブジェクト 構成オブジェクトを使用したコマンドラインでのビルド構成パラメーターの指定
ビルド スクリプト内の编码基因
コマンド ラインの编码基因(多数のパラメーターを指定) 構成オブジェクトのダイアログ ボックス ダイアログボックスを使用したコマンドラインでのビルド構成パラメーターの指定

ビルド構成パラメーターの指定

ビルド構成パラメーターは,MATLAB编码器の [プロジェクトの設定] ダイアログ ボックス、コマンド ラインまたは構成オブジェクトのダイアログ ボックスで指定できます。

MATLAB编码员アプリを使用したビルド構成パラメーターの指定

  1. [生成]ダイアログ ボックスを開くために、[コード生成)ページの[生成]矢印をクリックします。

  2. (要件に応じて)[ビルドタイプ][ソース コード][スタティック ライブラリ][ダイナミック ライブラリ]または(実行可能ファイル]に設定します。

  3. [詳細設定]をクリックします。

    [プロジェクトの設定]ダイアログボックスには,選択した出力タイプに適用可能な一連の構成パラメーターが表示されます。コード生成では、MEX 関数に対して、他のビルド タイプで使用されるものとは異なる一連の構成パラメーターが使用されます。出力タイプを(墨西哥人関数)[ソース コード][スタティック ライブラリ][ダイナミック ライブラリ]または(実行可能ファイル]の間で切り替える場合は、これらの設定を確認してください。

    特定の構成パラメーターは,墨西哥人コードとスタンドアロンコードの両方の生成に関連します。出力タイプが(墨西哥人関数)のときに,このようなパラメーターのいずれかを有効にし,その同じ設定をC / c++コードの生成に使用する場合,[C/C++スタティック ライブラリ][C/C++ダイナミック ライブラリ]および[C/C++実行ファイル]に対して再度有効にしなければなりません。

  4. 必要に応じてパラメーターを変更します。タブ上のパラメーターの詳細については,[ヘルプ]をクリックしてください。

    パラメーター設定の変更はすぐに適用されます。

構成オブジェクトを使用したコマンドラインでのビルド構成パラメーターの指定

構成オブジェクトの型-编码基因は構成オブジェクトを使用してコード生成環境をカスタマイズします。以下の表は、利用可能な構成オブジェクトの一覧です。

構成オブジェクト 説明

编码器。CodeConfig

使用可能な嵌入式编码器®ライセンスがない場合や,嵌入式编码器ライセンスの使用を無効にしている場合に,C / c++ライブラリや実行可能ファイルを生成するためのパラメーターを指定します。

coder.EmbeddedCodeConfig

嵌入式编码器ライセンスが使用可能な場合に,C / c++ライブラリや実行可能ファイルを生成するためのパラメーターを指定します。

编码器硬件实现

ターゲットハードウェア実行のパラメーターを指定します。指定しなかった場合,编码基因は MATLABホスト コンピューターと互換性のあるコードを生成します。

coder.MexCodeConfig

墨西哥人コード生成のためのパラメーターを指定します。

構成オブジェクトの取り扱い-構成オブジェクトを使用してコード生成環境をカスタマイズするには,以下の手順を行います。

  1. MATLABワークスペースで,構成オブジェクトの作成で説明されているように、構成オブジェクト変数を定義します。

    たとえばCスタティックライブラリを生成するための構成オブジェクトを生成するには次のようにします。

    cfg=coder.config('lib');%如果没有可用的%Embedded coder许可证,则返回coder.CodeConfig对象。%n否则,返回coder.EmbeddedCodeConfig对象。

  2. 必要に応じて,以下のいずれかの方法を使用して構成オブジェクトのパラメーターを変更します。

  3. -配置オプションを使用して、関数编码基因呼び出します。構成オブジェクトを引数に指定します。

    -配置オプションは、编码基因に対して、構成プロパティの値に基づいてターゲット用のコードを生成するよう指示します。次の例では、编码基因は最初のステップで定義したコード生成構成オブジェクトcfgのパラメーターに基づいて、MATLAB関数喷火からCスタティックライブラリを生成します。

    Codegen -config CFG foo

    -配置オプションはビルドする出力タイプを指定します。この場合は Cスタティック ライブラリです。詳細は、「编码基因」を参照してください。

構成オブジェクトの作成-構成オブジェクトは、MATLABワークスペースで定義できます。

作成するもの 使用するコマンド
墨西哥人構成オブジェクト

coder.MexCodeConfig
cfg = coder.config(墨西哥人);
スタンドアロンのC / c++ライブラリまたは実行可能ファイルを生成するためのコード生成構成オブジェクト

编码器。CodeConfig
%生成静态库cfg=coder.config('lib');%生成动态库cfg=coder.config('dll')%生成可执行文件cfg=coder.config('exe');

メモ

嵌入式编码器ライセンスが使用できる場合に、coder.EmbeddedCodeConfigオブジェクトを作成します。

コンカレント ライセンスを使用していて、嵌入式编码器ライセンスのチェックアウトを無効にするには、以下のいずれかのコマンドを使用します。

cfg =编码器。配置(‘自由’,‘是’,假)

cfg=coder.config('dll','ecoder',false)

cfg=coder.config('exe','ecoder',false)

組み込みターゲット用のスタンドアロンのC / c++ライブラリまたは実行可能ファイルを生成するためのコード生成構成オブジェクト

coder.EmbeddedCodeConfig
%生成静态库cfg=coder.config('lib');%生成动态库cfg=coder.config('dll')%生成可执行文件cfg=coder.config('exe');

メモ

嵌入式编码器ライセンスが必要です。ライセンスがない場合は、编码器。CodeConfigオブジェクトが作成されます。

ハードウェア実行構成オブジェクト

编码器硬件实现
hwcfg=编码器硬件实现

各構成オブジェクトに付属する一連のパラメーターは既定値に初期化されています。コマンド ラインでのドット表記を使用した構成オブジェクトの変更で説明されているように、これらの設定を変更できます。

コマンド ラインでのドット表記を使用した構成オブジェクトの変更-ドット表記を使用して、構成オブジェクトのパラメーター値を 1.つずつ変更できます。次の構文を使用します。

configuration_object。属性=值

ドット表記では代入ステートメントを使用して構成オブジェクトのプロパティを変更します。

  • C / c++コードの生成中に主要関数を指定する方法

    cfg = coder.config (exe);cfg。CustomInclude = 'c:\myfiles'; cfg.CustomSource = 'main.c'; codegen -config cfg foo

  • C/C++スタティック ライブラリの生成後、コード生成レポートを自動的に生成、起動する方法

    cfg=coder.config('lib');cfg.GenerateReport=true;cfg.LaunchReport=true;codegen-config cfg-foo

構成オブジェクトの保存-構成オブジェクトは,自動的にはMATLABセッション間で持続しません。以下のいずれかの方法を使用して設定を保存します。

構成オブジェクトを 小地毯ファイルに保存して、次のセッションで 小地毯ファイルを読み込む

構成オブジェクトの作成とプロパティの設定を行うスクリプトを作成します。

ダイアログボックスを使用したコマンドラインでのビルド構成パラメーターの指定

  1. 構成オブジェクトの作成の説明に従って、構成オブジェクトを作成します。

    たとえば、墨西哥コードの生成用のcoder.MexCodeConfig構成オブジェクトを作成するには,以下のようにします。

    mexcfg=coder.config('mex');

  2. 次のいずれかの方法でプロパティダイアログボックスを開きます。

    • MATLABワークスペースで,構成オブジェクト変数をダブルクリックします。

    • MATLABプロンプトで、次の例にあるように、構成オブジェクト変数を渡して打开コマンドを実行します。

      打开mexcfg

  3. ダイアログボックスで,必要に応じて構成パラメーターを変更してから,[適用]をクリックします。

  4. -配置オプションを使用して、関数编码基因呼び出します。構成オブジェクトを引数に指定します。

    codegen-配置mexcfg foo

    -配置オプションは、ビルドする出力タイプを指定します。詳細については、「编码基因」を参照してください。

プロパティ ダイアログ ボックスは、MATLAB在线™でサポートされていません。