mcc

デプロイする MATLAB 関数のコンパイル

ページ内をすべて折りたたむ

構文

mcc

mcc options mfilename1 mfilename2 ... mfilenameN

mcc('options','mfilename')

mcc -m options mfilename

mcc -e options mfilename

mcc -W 'excel:addin_name,className,version=version_number' options mfilename1 mfilename2 ... mfilenameN

mcc -H -W hadoop:archiveName,CONFIG:configFile mfilename

mcc -m options mfilename

説明

その他の `mcc` トピック

このトピックでは、MATLAB^® Compiler™ で使用する mcc オプションについて説明します。コンパイルについての詳細は、次を参照してください。

C/C++ 共有ライブラリ、.NET アセンブリ、Java^® パッケージ、または Python^® パッケージについては、mcc (MATLAB Compiler SDK) を参照
MATLAB Production Server™ のデプロイ可能アーカイブまたは MATLAB Production Server 用 Excel^® アドインについては、mcc (MATLAB Production Server) を参照

一般的な使用方法

mcc options mfilename1 mfilename2 ... mfilenameN はオプションの指定に従って関数をコンパイルします。使用するオプションは、意図するコンパイル結果によって異なります。

mcc('options','mfilename') はオプションの指定に従って関数をコンパイルします。ファイル名、オプション、およびオプションパラメーターを一重引用符で囲んで指定します。

スタンドアロンアプリケーション

例

mcc -m options mfilename は、関数をコンパイルしてスタンドアロンアプリケーションにします。

この構文は mcc -W main -T link:exe と等価です。

例

mcc -e options mfilename は、関数をコンパイルして、実行時に Windows^® コマンドプロンプトを開かないスタンドアロンアプリケーションにします。-e オプションは Windows オペレーティングシステムでのみ機能します。

この構文は -W WinMain -T link:exe と等価です。

Excel アドイン

例

mcc -W 'excel:addin_name,className,version=version_number' options mfilename1 mfilename2 ... mfilenameN は、指定されたファイルから Microsoft^® Excel アドインを作成します。

addin_name — アドインの名前を指定します。
className — 作成するクラスの名前を指定します。クラス名を指定しない場合、mcc は addin_name を既定値として使用します。指定する場合、className は mfilename とは異なるものでなければなりません。
version_number — アドインファイルのバージョン番号を、ファイルシステムの major.minor.bug.build として指定します。バージョン番号の指定は必須ではありません。バージョン番号を指定しない場合、mcc はバージョン番号を既定で 1.0.0.0 に設定します。
- major — メジャーバージョン番号を指定します。番号を指定しない場合、mcc は major を 0 に設定します。
- minor — マイナーバージョン番号を指定します。番号を指定しない場合、mcc は minor を 0 に設定します。
- bug— バグ修正メンテナンスリリース番号を指定します。番号を指定しない場合、mcc は bug を 0 に設定します。
- build— ビルド番号を指定します。番号を指定しない場合、mcc は build を 0 に設定します。
メモ
Excel アドインは、Windows で実行される MATLAB でのみ作成できます。
メモ
DOS プロンプトで mcc コマンドを実行する場合は、'excel:addin_name,className,version' を囲む一重引用符を削除します。

Hadoop の MapReduce アプリケーション

mcc -H -W hadoop:archiveName,CONFIG:configFile mfilename は、mfilename から Hadoop^® がジョブとして実行できるデプロイ可能なアーカイブを生成します。

archiveName — 生成されたアーカイブの名前を指定します。
configFile — デプロイ可能なアーカイブ作成用の構成ファイルのパスを指定します。詳細については、mcc コマンドを使用して配布可能なアーカイブを作成するための構成ファイルを参照してください。

ヒント

mcc コマンドは、MATLAB コマンドプロンプト、あるいは Windows システムまたは Linux^® システムのコマンドラインから発行できます。

Simulink シミュレーション (Simulink Compiler が必要)

例

mcc -m options mfilename は、Simulink^® シミュレーションを含む MATLAB アプリケーションをスタンドアロンアプリケーションにコンパイルします。詳細については、Create and Deploy a Script with Simulink Compiler (Simulink Compiler)を参照してください。

例

スタンドアロンアプリケーションの作成

mcc -m magic.m

コマンドシェルを開かないスタンドアロンアプリケーションの作成 (Windows のみ)

mcc -e magic.m

システムレベルファイルのバージョン番号をもつスタンドアロンアプリケーションの作成 (Windows のみ)

Windows で、バージョン番号が 3.4.1.5 のスタンドアロンアプリケーションを作成します。

mcc -W 'main:mymagic,version=3.4.1.5' mymagic.m

スタンドアロンアプリケーションを作成して MATLAB の基本設定を含める

mcc -m helloWorld.m -a C:\Users\someuser\AppData\Roaming\MathWorks\MATLAB\R2022b\matlab.mlsettings

Excel アドインの作成

mcc -W 'excel:myAddin,myClass,1.0' magic.m

システムレベルファイルのバージョン番号をもつ Excel アドインの作成 (Windows のみ)

Windows で、バージョン暗号が 5.2.1.7 の Excel アドインを作成します。

mcc -W 'excel:myAddin,myClass,version=5.2.1.7' -b mymagic.m

Simulink シミュレーション用のスタンドアロンアプリケーションの作成 (Simulink Compiler が必要)

Simulink シミュレーション用のスタンドアロンアプリケーションを作成するには、次を行います。

Simulink を使用して Simulink モデルを作成します。この例では、モデル sldemo_suspn_3dof を使用します。

モデルのシミュレーションに Simulink Compiler の API を使用する MATLAB アプリケーションを作成します。詳細については、Deploy Simulations with Tunable Parameters (Simulink Compiler)を参照してください。

function deployParameterTuning(outputFile, mbVariable)
 
    if ischar(mbVariable) || isstring(mbVariable)
        mbVariable = str2double(mbVariable);
    end
     
    if isnan(mbVariable) || ~isa(mbVariable, 'double') || ~isscalar(mbVariable)
        disp('mb must be a double scalar or a string or char that can be converted to a double scalar');
    end
     
    in = Simulink.SimulationInput('sldemo_suspn_3dof');   
    in = in.setVariable('Mb', mbVariable);
    in = simulink.compiler.configureForDeployment(in);
    out = sim(in);
     
    save(outputFile, 'out');
  
end

mcc を使用して、MATLAB アプリケーションからスタンドアロンアプリケーションを作成します。

mcc -m deployParameterTuning.m

入力引数

すべて折りたたむ

`mfilename` — コンパイル対象のファイル
ファイル名

コンパイル対象のファイル。文字ベクトルまたは string スカラーとして指定します。

`mfilename1 mfilename2 ... mfilenameN` — コンパイル対象のファイル (複数)
ファイル名のリスト

1 つ以上のコンパイル対象のファイル。スペース区切りのファイル名のリストとして指定します。最初のファイルは、コンパイルされたアーティファクトのエントリポイントとして使用されます。

`options` — 出力をカスタマイズするオプション
-a | -b | -B | -c | -C | -d | -f | -g | -G | -I | -j | -k | -K | -m | -M | -n | -N | -o | -p | -r | -R | -s | -S | -T | -u | -u | -v | -w | -W | -X | -Y | -Z

出力をカスタマイズするオプション。文字ベクトルまたは string スカラーのリストとして指定します。

-a
-a filepath を使用して追加するファイルを指定し、デプロイ可能なアーカイブにファイルを追加します。複数の -a オプションを指定できます。
また、-a path\to\mymatlab.mlsettings を使用して追加する基本設定を指定し、デプロイアプリケーションに MATLAB の基本設定を追加します。
-a を使用してファイル名を指定した場合、コンパイラはこれらのファイルを MATLAB パスで検索するため、絶対パス名の指定は任意となります。これらのファイルは mbuild へ渡されないため、データファイルなどのファイルを指定してもかまいません。詳細については、パッケージ化されたアプリケーションでのファイルへのアクセスを参照してください。
-a オプションでフォルダー名を指定した場合、そのフォルダーのすべてのファイルがデプロイ可能なアーカイブに再帰的に追加されます。たとえば、
```
mcc -m hello.m -a ./testdir 
```
は、testdir 内のすべてのファイルとそのサブフォルダー内のすべてのファイルがデプロイ可能なアーカイブに追加されるよう指定します。testdir 内のフォルダーサブツリーはデプロイ可能なアーカイブ内で保持されます。
ファイル名にワイルドカードパターンが含まれる場合、フォルダー内でパターンに一致するファイルのみがデプロイ可能なアーカイブに追加され、指定したパスのサブフォルダーは再帰的に処理されません。たとえば、
```
mcc -m hello.m -a ./testdir/*
```
は、./testdir のすべてのファイルがデプロイ可能なアーカイブに追加され、./testdir のサブフォルダーは再帰的に処理されないよう指定します。
```
mcc -m hello.m -a ./testdir/*.m
```
は、./testdir の直下にあり、拡張子が .m であるすべてのファイルがデプロイ可能なアーカイブに追加され、./testdir のサブフォルダーは再帰的に処理されないよう指定します。
メモ
サポートされているワイルドカードは * のみです。
コンパイル時に MATLAB パス上で表示されないファイルを、-a を使用してデプロイ可能なアーカイブに追加する場合、ファイルがデプロイコードの実行時にパス上に表示されるように、デプロイアプリケーションの実行時パスにパスエントリが追加されます。
リソースへの絶対パスを指定するために -a オプションを使用する場合、基本的なパスは維持されますが、ユーザーのローカルフォルダーではなく、ランタイムキャッシュディレクトリのサブディレクトリを基準に多少の変更が加えられます。キャッシュディレクトリは、アプリケーションの初回実行時に、デプロイ可能なアーカイブから作成されます。関数 isdeployed を使用することで、アプリケーションがデプロイモードで実行されているかどうかを判定し、それに応じてパスを調整できます。-a オプションはまた、認証用の .auth ファイルも作成します。
注意
MATLAB パス上にないファイルを含めるために -a フラグを使用した場合、ファイルを含むフォルダーが MATLAB 依存関係の解析パスに追加されます。その結果、そのフォルダー内の他のファイルがコンパイルされたアプリケーションに含められる場合があります。
メモ
カスタム Java クラスを含めるために -a フラグを使用する場合、Java クラスがパッケージのメンバーではない限り、スタンドアロンアプリケーションは classpath を変更しなくても動作します。これは JAR ファイルにもあてはまります。ただし、追加するクラスがパッケージのメンバーである場合、パッケージの親フォルダーの classpath を更新するために、MATLAB コードで javaaddpath を正しく呼び出す必要があります。
-A
サポートされるプラットフォームをコンパイラで自動的に検出されたものに追加します。次の構文を使用します。
```
-A arch
```
arch で指定されたプラットフォームを互換性のあるプラットフォームのリストに追加します。有効なプラットフォームは win64、maci64、glnxa64 および all です。-A オプションは、Python、MATLAB データ配列 API を使用した C/C++、および Java ターゲットにのみ適用されます。
互換性のないプラットフォームでコンポーネントを実行すると、サポートされていないプラットフォームのエラーメッセージが表示され、互換性のあるプラットフォームがリストされます。
-b
Visual Basic^® ファイル (.bas) を生成します。そのファイルには、MATLAB Compiler で生成された COM オブジェクトに対応する Microsoft Excel の数式関数インターフェイスが含められています。ワークブックの Visual Basic コードにインポートすると、このコードでは MATLAB 関数がセル数式関数として表示されるようになります。
-B
mcc コマンドライン上のファイルを、指定したファイルの内容で置き換えます。次の構文を使用します。
```
-B filename[:<a1>,<a2>,...,<an>]
```
バンドル filename には、mcc コマンドラインオプションと、それに対応する引数や他のファイル名のみを含めなければなりません。このファイルには他の -B オプションが含まれている場合があります。バンドルは、コンパイラオプションの名前やバージョン番号のパラメーターの置き換えを含むことができます。Using Bundles to Build MATLAB Code (MATLAB Compiler SDK)を参照してください。
-c
-l オプションとあわせて使用すると、生成された C ラッパーコードのコンパイルとリンクが省略されます。-c オプションは、-l オプションから独立して使用することはできません。
-C
デプロイ可能なアーカイブをバイナリに組み込みません。
メモ
-C フラグは Java ライブラリでは無視されます。
-d
指定したフォルダーに出力を置きます。次の構文を使用します。
```
-d outFolder
```
生成されたファイルが outFolder に送られるようになります。指定したフォルダーが既に存在していなければなりません。
-e
オプション -m の代わりに -e を使用して、実行時に Windows コマンドプロンプトを開かないスタンドアロンの Windows アプリケーションを生成します。-e は -W WinMain -T link:exe と等価です。
このオプションは Windows オペレーティングシステムでのみ機能します。
-f
指定したオプションファイルで既定のオプションファイルを無効にします。具体的には C/C++ 共有ライブラリ、COM、Excel の各ターゲットが該当します。次の構文を使用します。
```
-f filename
```
これで、mbuild を呼び出すときのオプションファイルとして filename を指定します。このオプションにより、コンパイラの別の呼び出しに対して別の ANSI コンパイラを使用できるようになります。このオプションは mbuild へのダイレクトパススルーです。
-g, -G
MATLAB Compiler SDK™ で生成した C/C++ コード用のデバッグシンボル情報を含めます。これによって、mbuild から C/C++ コンパイラへ適切なデバッグフラグが渡されます。このデバッグオプションを使用すると、MATLAB Runtime の初期化、関数呼び出し、または終了ルーチンのいずれでエラーが発生したかを特定できる箇所まで戻ることができます。このオプションでは、C/C++ デバッガーで MATLAB ファイルをデバッグすることはできません。
-h
カスタムヘルプテキストファイルを指定します。このオプションはスタンドアロンアプリケーション、C/C++ 共有ライブラリ、COM、Excel の各ターゲットが該当します。次の構文を使用します。
```
-f filename
```
filename をカスタムヘルプテキストファイルとして含めます。コマンドラインで -? または /? 引数を指定し、アプリケーションを呼び出して、ヘルプファイルの内容を表示します。
-I
インクルードフォルダーのリストへ新しいフォルダーパスを追加します。各 -I オプションは、検索パスのリストの末尾にフォルダーを追加します。たとえば、
```
-I <directory1> -I <directory2>
```
は、MATLAB ファイルが最初に directory1 で検索され、次に directory2 で検索されるように検索パスを設定します。このオプションは MATLAB パスが利用できないところでスタンドアロンをコンパイルするときに重要です。
-N オプションと併用する場合、-I オプションはフォルダーをコンパイルパスの先頭ではなく、MATLAB パス内で表示された場所と同じコンパイルパス内の場所に追加します。
-j
自動的にすべての .m ファイルを P ファイルに変換してからパッケージ化します。-j オプションは mcc コマンドに含まれる各 .m ファイルに対して、.p 拡張子の付いた P コードファイルを生成します。
P コードファイルは、MATLAB コードを難読化した、実行のみの形式です。詳細については、pcode を参照してください。
-k
AES 暗号化キーと、実行時に復号化キーを取得するための MEX ファイルのローダーインターフェイスを指定します。
次の構文を使用します。
```
-k "file=<key_file_path>;loader=<mex_file_path>"
```
キーファイルと MEX ファイルへのパスを指定します。
キーファイルは、サポートされている次のいずれかの形式でなければなりません。
- バイナリ 256 ビットの AES キー、32 バイトのファイルサイズ
- 16 進数でエンコードされた AES キー、64 文字のファイルサイズ
ローダー MEX ファイルは次の引数をもつインターフェイスでなければなりません。
- prhs[0] — 入力、固定値 'getKey' として指定される文字型配列
- prhs[1] — 入力、CTF コンポーネント UUID として指定される文字型配列
- plhs[0] — 出力、32 バイトの UINT8 数値配列または 64 バイトの 16 進数でエンコードされた文字列配列
-k の後に引数を指定しないと、mcc はデモンストレーション目的で使用できる 256 ビットの AES キーとローダー MEX ファイルを生成します。
-K
エラーによってコンパイルが途中で終了する場合に、出力ファイルを削除しないよう mcc に指示します。
mcc の既定の動作では、コマンドが正常に実行されない場合はすべての部分出力が破棄されます。
-l
関数ライブラリを生成します。-l は -W lib -T link:lib と等価です。このオプションは deploytool アプリで使用できません。
-m
スタンドアロンアプリケーションを生成します。-m は -W main -T link:exe と等価です。このオプションは deploytool アプリで使用できません。

-M

コンパイル時のオプションを定義します。次の構文を使用します。

-M string

これで、mbuild へ string を直接渡します。たとえば -M "-Dmacro=value" のように、このオプションはコンパイル時のオプションを定義するための有用な方法を提供します。

メモ

-M オプションを複数指定することはできません。複数指定した場合、最も右にある -M オプションのみが使用されます。

/bigobj などのオプションを渡すには、プラットフォームに応じて文字列を記述します。

プラットフォーム	構文
MATLAB	-M 'COMPFLAGS=$COMPFLAGS /bigobj'
Windows コマンドプロンプト	-M COMPFLAGS="$COMPFLAGS /bigobj"
Linux および macOS のコマンドライン	-M CFLAGS='$CFLAGS /bigobj'

-n
-n オプションを使用すると、数値のコマンドライン入力が自動的に特定され、MATLAB double として扱われます。
-N
-N を渡すと、以下のコアフォルダーを除く、すべてのフォルダーのパスが消去されます (このリストは将来変更の可能性があります)。
- matlabroot\toolbox\matlab
- matlabroot\toolbox\local
- matlabroot\toolbox\compiler
- matlabroot\toolbox\shared\bigdata
-N が渡されると、このリストのサブフォルダーもすべて保持され、コンパイル時に MATLAB パスに表示されます。コマンドラインに -N を含めると、オリジナルのパスでフォルダーを置き換えることができます。一方で、パスに含まれているフォルダーの相対的な順序は保持されます。オリジナルのパスに含まれるフォルダー内のすべてのサブフォルダーも含まれます。さらに、-N オプションは、matlabroot\toolbox の下位にないパスで含めたすべてのフォルダーも保持します。
–N オプションを使用するときに、コンパイルパスの先頭に配置されるフォルダーを強制的に含めるには、–I を使用します。条件付きでフォルダーおよびサブフォルダーを含めるようにするには、–p オプションを使用します。フォルダーおよびサブフォルダーが MATLAB パスにある場合、コンパイルパス内に同じ順序で表示されます。
-o
最終的な実行可能ファイル (スタンドアロンアプリケーションのみ) の名前を指定します。次の構文を使用します。
```
-o outputfile
```
これで、MATLAB Compiler によって出力される最終的な実行可能ファイルに名前を付けます。指定した名前には、プラットフォームによって決まる適切な拡張子が追加されます (たとえば Windows スタンドアロンアプリケーションでは .exe)。
-p
オプション -N と共に使用し、matlabroot\toolbox にある特定のフォルダーとサブフォルダーを MATLAB のコンパイルパスに追加します。ファイルは MATLAB パス上の表示と同じ順序で追加されます。次の構文
```
-N -p directory
```
ここで directory は、追加するフォルダーです。directory が絶対パスでない場合、現在の作業フォルダーの下とみなされます。
- オリジナルの MATLAB パス上に存在するフォルダーを -p で指定する場合、オリジナルパス上のフォルダーとすべてのサブフォルダーは、オリジナルのパスと同じ順序でコンパイルパスに追加されます。
- オリジナルの MATLAB パス上にないフォルダーを -p で指定する場合、このフォルダーは無視されます (このフォルダーを強制的に含めるには -I を使用します)。
-r
リソースアイコンをバイナリ形式で組み込みます。構文は以下のようになります。
```
-r 'path/to/my_icon.ico'
```

-R

初期化時にアプリケーションに渡される MATLAB Runtime のオプションを提供します。

メモ

このオプションは、MATLAB Compiler を使用してスタンドアロンアプリケーションまたは Excel アドインをビルドする場合にのみ使用できます。MATLAB Compiler SDK から作成されたライブラリに対して -R を指定した場合でも、mcc はコンパイルされ、結果が生成されますが、-R オプションはこれらのライブラリには適用されず、何も実行されません。

構文は以下のようになります。

-R option

オプション	説明	ターゲット
`'-logfile,filename'`	ログファイル名を指定します。このファイルは実行時にアプリケーションフォルダー内に作成されます。これには MATLAB Runtime の初期化に関する情報と、コマンドウィンドウにパイプされているすべてのテキストが含まれます。オプションは一重引用符で囲まなければなりません。Windows コマンドプロンプトからコマンドを実行する場合は、二重引用符を使用します。	MATLAB Compiler
`-nodisplay`	MATLAB `nodisplay` の実行時警告を抑制します。Linux で、MATLAB Runtime を表示機能なしで開きます。	MATLAB Compiler
`-nojvm`	JVM (Java 仮想マシン) を使用しません。	MATLAB Compiler
`'-startmsg,message'`	初期化開始時にカスタマイズ可能なユーザーメッセージを表示します。詳細については、MATLAB Runtime の初期化メッセージの表示を参照してください。	MATLAB Compiler スタンドアロンアプリケーション
`'-completemsg,message'`	初期化完了時にカスタマイズ可能なユーザーメッセージを表示します。詳細については、MATLAB Runtime の初期化メッセージの表示を参照してください。	MATLAB Compiler スタンドアロンアプリケーション
`-singleCompThread`	MATLAB を単一の計算スレッドに制限します。	MATLAB Compiler
`-softwareopengl`	レンダリングに Mesa Software の OpenGL^® を使用します。	MATLAB Compiler

注意

macOS 上での実行時に、mclInitializeApplication に含めるオプションの 1 つとして -nodisplay を使用する場合、mclInitializeApplication の呼び出しは mclRunMain の呼び出しよりも前になければなりません。

-s
エンドユーザーからのデプロイ可能なアーカイブ (.ctf ファイル) 内でフォルダー構造とファイル名を難読化します。オプションで追加のファイルタイプを暗号化します。
-s オプションは、.m ファイル、.p ファイル、v7.3 .mat ファイル、および MEX ファイルに含まれるユーザーコードとデータを、CTF 内のユーザーパッケージに配置するよう mcc に指示します。実行時に、MATLAB コードとデータはファイルシステムに抽出されるのではなく、ユーザーパッケージから直接復号化されて読み込まれます。MEX ファイルは、一時的にユーザーパッケージから抽出されてから、読み込まれます。
追加のファイルタイプをユーザーパッケージに手動で含めるには、それぞれのファイルタイプを個別の拡張子タグでファイル matlabroot/toolbox/compiler/advanced_package_supported_files.xml に追加します。
以下はサポートされていません。
- 関数 ver
- アウトプロセスの MATLAB Runtime (MATLAB データ配列の C++ 共有ライブラリ)
- アウトプロセスでの MEX ファイルの実行 (mexhost、feval、matlab.mex.MexHost)

-S

すべてのクラスインスタンスで共有される単一の MATLAB Runtime インスタンスを作成します。

MATLAB Runtime の標準動作では、クラスの各インスタンスが固有の MATLAB Runtime コンテキストを取得します。このコンテキストには、パスなどの変数に対応するグローバル MATLAB ワークスペースと、クラス内の各関数に対応するベースワークスペースが含まれます。1 つのクラスをもつインスタンスが複数作成された場合、各インスタンスは独自のコンテキストを取得します。これにより、該当クラスの 1 つのインスタンスにおいてグローバルワークスペースまたはベースワークスペースに行われた変更が、同じクラスの別のインスタンスに影響しないようになります。

シングルトン MATLAB Runtime では、1 つのクラスのすべてのインスタンスがコンテキストを共有します。1 つのクラスに複数のインスタンスが作成される場合、それらのインスタンスは最初のインスタンスによって生成されたコンテキストを使用するため、起動時間と一部のリソースが節減されます。ただし、1 つのインスタンスによりグローバルワークスペースまたはベースワークスペースに行われた任意の変更は、すべてのクラスインスタンスに影響します。たとえば、シングルトン MATLAB Runtime で instance1 がグローバル変数 A を作成した場合、instance2 は変数 A を使用できます。

これらの特定のターゲットでは、シングルトン MATLAB Runtime は以下の製品によってのみサポートされます。

シングルトン MATLAB Runtime がサポートするターゲット	シングルトン MATLAB Runtime の作成手順
Excel アドイン	ターゲットの既定の動作はシングルトン MATLAB Runtime です。行わなければならないその他の手順はありません。
.NET アセンブリ	ターゲットの既定の動作はシングルトン MATLAB Runtime です。行わなければならないその他の手順はありません。
COM コンポーネント	ライブラリコンパイラアプリを使用して、[設定] をクリックし、[MCC に渡される追加パラメーター] フィールドに `-S` を追加します。 `mcc` を使用して `-S` フラグを渡します。
Java パッケージ

-T

出力ターゲットの段階とタイプを指定します。指定しない場合、mcc は -W オプションで指定されたターゲットの既定のタイプを使用します。

構文 -T target を使用して出力タイプを定義します。

ターゲット	説明
`compile:exe`	C/C++ ラッパーファイルを生成し、C/C++ ファイルをスタンドアロンアプリケーションへのリンクに適したオブジェクト形式にコンパイルします。
`compile:lib`	C/C++ ラッパーファイルを生成し、C/C++ ファイルを共有ライブラリまたは DLL へのリンクに適したオブジェクト形式にコンパイルします。
`link:exe`	`compile:exe` と同じですが、さらにオブジェクトファイルをスタンドアロンアプリケーションにリンクします。
`link:lib`	`compile:lib` と同じですが、さらにオブジェクトファイルを共有ライブラリまたは DLL にリンクします。

-u
開発マシンのみにおいて、現在のユーザーに対する COM コンポーネントを登録します。この引数は汎用 COM コンポーネントと Microsoft Excel アドインのターゲットにのみ適用されます。
-U
MATLAB Production Server 用のデプロイ可能なアーカイブ (.ctf ファイル) をビルドします。
-v
詳細な出力を表示します。出力には次の内容を含むコンパイル手順が表示されます。
- MATLAB Compiler のバージョン番号
- 処理されるソースファイル名
- 生成する出力ファイル名
- mbuild の起動
-v オプションは mbuild へ -v を渡し、mbuild に関する情報を示します。

-w

警告メッセージを表示します。次の構文

-w option [:<msg>]

は、警告表示を制御します。

構文	説明
`-w list`	コンパイル時警告のリストを表示します。この警告には、ID の短縮形とそのステータスが含まれます。
`-w enable`	すべてのコンパイル時警告を有効にします。
`-w disable[:<string>]`	`<string>` に関連付けられた特定のコンパイル時警告を無効にします。すべてのコンパイル時警告に `disable` アクションを適用するには、オプションの `<string>` を省略します。
`-w enable[:<string>]`	`<string>` に関連付けられた特定のコンパイル時警告を有効にします。すべてのコンパイル時警告に `enable` アクションを適用するには、オプションの `<string>` を省略します。
`-w error[:<string>]`	`<string>` に関連した特定のコンパイル時警告と実行時警告をエラーとして扱います。すべてのコンパイル時警告と実行時警告に `error` アクションを適用するには、オプションの `<string>` を省略します。
`-w off[:<string>]`	`<string>` で定義された特定のエラーメッセージに対して警告をオフにします。すべての実行時警告に `off` アクションを適用するには、オプションの `<string>` を省略します。
`-w on[:<string>]`	`<string>` に関連付けられた実行時警告を有効にします。すべての実行時警告に `on` アクションを適用するには、オプションの `<string>` を省略します。このオプションは既定で有効になっています。

MATLAB コード内で警告をオンまたはオフに設定することもできます。

たとえば、デプロイされたアプリケーション (isdeployed を使用して指定) に対する警告を startup.m でオフにするには、次のように記述します。

if isdeployed
    warning off
end

デプロイされたアプリケーションに対して警告をオンにするには、次にのように記述します。

if isdeployed
    warning on
end

-w オプションを複数指定することもできます。

たとえば、repeated_file 以外のすべての警告を無効にするには、次のように指定します。

-w disable -w enable:repeated_file

複数の -w オプションを指定すると、左から右に向かって順番に処理されます。

-W
ラッパー関数の生成を制御します。次の構文
```
-W type 
```
を使用して、コンパイラにより生成された MATLAB ファイルの集合に対する関数ラッパーの生成を制御します。関数のリストを指定すると、コンパイラはラッパー関数および任意の適切なグローバル変数定義を生成します。
ターゲット構文
メモ
Windows コマンドプロンプトからコマンドを実行する場合は、一重引用符を二重引用符に置き換えます。
-X
-X を使用すると、依存関係の解析時に共通の MATLAB ファイル I/O 関数によって読み取られるデータファイルが無視されます。詳細については、MATLAB Compiler を使用した依存関係の解析を参照してください。-X オプションの使用方法の例は、%#exclude を参照してください。
-Y
次の構文を使用します。
```
 -Y license.lic
```
これで、指定した引数で既定のライセンスファイルをオーバーライドします。
メモ
-Y フラグはコマンドラインモードでのみ動作します。
```
>>!mcc -m foo.m -Y license.lic
```

-Z

次の構文を使用します。

-Z option

デプロイ可能なアーカイブにサポートパッケージを追加する方法を指定します。

構文	説明
`-Z 'autodetect'`	依存関係の解析プロセスにより、必要なサポートパッケージが自動的に検出され、含められます。これは mcc の既定の動作です。
`-Z 'none'`	サポートパッケージは含められません。このオプションを使用すると、ランタイムエラーの原因となる可能性があります。
`-Z packagename`	指定されたサポートパッケージのみが含められます。複数のサポートパッケージを指定するには、複数の `-Z` 入力を使用します。

メモ

インストールされている、または特定のファイルで使用されるサポートパッケージのリストを表示するには、compiler.codetools.deployableSupportPackages を参照してください。

ヒント

Windows では、mcc 構文を生成するターゲットに version=version_number を追加することにより、ターゲットファイルのシステムレベルファイルのバージョン番号を生成できます。例については、システムレベルファイルのバージョン番号をもつスタンドアロンアプリケーションの作成 (Windows のみ)を参照してください。
version_number — ターゲットファイルのバージョンを、ファイルシステムの major.minor.bug.build として指定します。バージョン番号の指定は必須ではありません。バージョン番号を指定しない場合、mcc はバージョン番号を既定で 1.0.0.0 に設定します。
- major — メジャーバージョン番号を指定します。バージョン番号を指定しない場合、mcc は major を 1 に設定します。
- minor — マイナーバージョン番号を指定します。バージョン番号を指定しない場合、mcc は minor を 0 に設定します。
- bug— バグ修正メンテナンスリリース番号を指定します。バージョン番号を指定しない場合、mcc は bug を 0 に設定します。
- build — ビルド番号を指定します。バージョン番号を指定しない場合、mcc は build を 0 に設定します。
この機能は、スタンドアロンアプリケーションと、MATLAB Compiler の Excel アドインでサポートされています。MATLAB Compiler SDK でサポートされるターゲットについては、mcc (MATLAB Compiler SDK) の「ヒント」の節を参照してください。

バージョン履歴

R2006a より前に導入

mcc

構文

説明

その他の mcc トピック

一般的な使用方法

スタンドアロン アプリケーション

Excel アドイン

Hadoop の MapReduce アプリケーション

Simulink シミュレーション (Simulink Compiler が必要)

例

スタンドアロン アプリケーションの作成

コマンド シェルを開かないスタンドアロン アプリケーションの作成 (Windows のみ)

システム レベル ファイルのバージョン番号をもつスタンドアロン アプリケーションの作成 (Windows のみ)

スタンドアロン アプリケーションを作成して MATLAB の基本設定を含める