このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
mcc
デプロイする MATLAB 関数のコンパイル
構文
説明
mcc
を使用して、MATLAB® プログラムをスタンドアロン アプリケーション、Excel® アドイン、Spark™ アプリケーション、または Hadoop® ジョブとしてパッケージ化およびデプロイできます。
MATLAB Compiler SDK™ のライセンスがある場合は、mcc
を使用して C/C++ 共有ライブラリ、.NET アセンブリ、Java® パッケージ、Python® パッケージ、MATLAB Production Server™ デプロイ可能アーカイブ、または MATLAB Production Server 用 Excel アドインを作成できます。
一般的な使用方法
mcc [options]
はオプションの指定に従って関数をコンパイルします。使用するオプションは、意図するコンパイル結果によって異なります。最初のファイルは、コンパイルされたアーティファクトのエントリ ポイントとして機能します。mfilename1 mfilename2 ... mfilenameN
システム コマンド プロンプトからこの構文を呼び出すこともできます。
メモ
特殊文字 (ピリオドやスペースなど) が含まれている引数は単一引用符で囲む必要があります。Windows® コマンド プロンプトから実行する場合は、二重引用符を使用します。
mcc(options,
はオプションの指定に従って関数をコンパイルします。文字ベクトルまたは string としてファイル名およびオプションを指定します。この構文では、MATLAB 変数を入力引数として使用できます。mfilename
)
スタンドアロン アプリケーション
mcc -m [options]
は、関数をコンパイルしてスタンドアロン アプリケーションにします。実行可能ファイルのタイプは、オペレーティング システムにより決定されます。mfilename
また、関数 compiler.build.standaloneApplication
ではほとんどの一般的なワークフローがサポートされています。
mcc -e [options]
は、関数をコンパイルして、実行時に Windows コマンド プロンプトを開かないスタンドアロン アプリケーションにします。mfilename
-e
オプションは Windows オペレーティング システムでのみ機能します。
また、関数 compiler.build.standaloneWindowsApplication
ではほとんどの一般的なワークフローがサポートされています。
Excel アドイン
mcc -W 'excel:
は、指定されたファイルを使用して Microsoft® Excel アドインを作成します。Excel アドインを作成する前に、サポートされているコンパイラをインストールしてください。addin_name
,class_name
,version=version_number
' [options] mfilename1 mfilename2 ... mfilenameN
Windows では Excel アドインのみを作成できます。
addin_name
— アドインの名前を指定します。名前を指定しない場合、mcc
は
を既定値として使用します。mfilename1
class_name
— 作成するクラスの名前を指定します。クラス名を指定しない場合、mcc
はaddin_name
をクラス名として使用します。指定する場合、class_name
は
とは異なるものでなければなりません。mfilename1
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
に設定します。
また、関数 compiler.build.excelAddIn
ではほとんどの一般的なワークフローがサポートされています。
Hadoop の MapReduce アプリケーション
Linux® のみ
mcc -W 'hadoop:
は、archive_name
,CONFIG:config_file
' mfilename
mfilename
から Hadoop がジョブとして実行できるデプロイ可能なアーカイブを生成します。
archive_name
— 生成されたアーカイブの名前を指定します。config_file
— デプロイ可能なアーカイブ作成用の構成ファイルのパスを指定します。詳細については、mcc コマンドを使用してデプロイ可能なアーカイブを作成するための構成ファイルを参照してください。
Simulink シミュレーション
Simulink® Compiler™ が必要です。
mcc -m [options]
は、Simulink シミュレーションを含む MATLAB アプリケーションをスタンドアロン アプリケーションにコンパイルします。詳細については、Create and Deploy a Script with Simulink Compiler (Simulink Compiler)を参照してください。mfilename
Python パッケージ
MATLAB Compiler SDK が必要です。
mcc -W python:
は、指定されたファイルを使用して Python パッケージを作成します。package_name
[options] mfilename1 mfilename2 ... mfilenameN
package_name
— オプションの名前空間で始まる Python パッケージの名前を指定します。これは、companyname.groupname.component
のようにピリオドで区切られたリストです。
また、関数 compiler.build.pythonPackage
(MATLAB Compiler SDK) ではほとんどの一般的なワークフローがサポートされています。
.NET アセンブリ
mcc -W 'dotnet:
は、指定されたファイルを使用して単一のクラスをもつ .NET アセンブリを作成します。.NET アセンブリを作成する前に、MATLAB Compiler SDK の .NET ターゲットの要件 (MATLAB Compiler SDK)を参照してください。assembly_name
,api=api_type
,class_name
,framework_version
,security
,remote_type
' [options] mfilename1 mfilename2 ... mfilenameN
assembly_name
— オプションの名前空間で始まるアセンブリの名前を指定します。これは、companyname.groupname.component
のようにピリオドで区切られたリストです。api_type
— アセンブリの API の型を指定します。値はmatlab-data
およびmwarray
です。既定値はmwarray
です。class_name
— 作成する .NET クラスの名前を指定します。framework_version
— アセンブリのコンパイルに使用する Microsoft .NET Framework のバージョンを指定します。次のいずれかを指定してください。0.0
— ターゲット マシンでサポートされる最新バージョンを使用。
— 特定バージョンの Framework を使用。version_major
.version_minor
機能は、多くの場合バージョンに固有です。実装する機能のドキュメンテーションを参照し、Microsoft .NET Framework のバージョンの要件を取得してください。
security
— 作成するアセンブリがプライベート アセンブリか共有アセンブリかを指定します。プライベート アセンブリを作成するには、
Private
を指定。共有アセンブリを作成するには、アセンブリの署名に使用される暗号化キー ファイルへの絶対パスを指定。
remote_type
— アセンブリのリモート処理タイプを指定します。値はremote
およびlocal
です。
mcc -W 'dotnet:
は、指定されたファイルを使用して複数のクラスをもつ .NET アセンブリを作成します。引数 assembly_name
,api=api_type
,class_name
,framework_version
,security
,remote_type
' [options] 'class{class_name:mfilename1,mfilename2,...,mfilenameN}
'class{___}
を追加して、追加のクラス指定子を含めることができます。
また、関数 compiler.build.dotNETAssembly
(MATLAB Compiler SDK) ではほとんどの一般的なワークフローがサポートされています。
Java パッケージ
MATLAB Compiler SDK が必要です。
mcc -W 'java:
は、指定されたファイルから Java パッケージを作成します。Java パッケージを作成する前に、Java パッケージの生成環境の構成 (MATLAB Compiler SDK)を参照してください。package_name
,class_name
' [options] mfilename1 mfilename2 ... mfilenameN
package_name
— オプションの名前空間で始まる Java パッケージの名前を指定します。これは、companyname.groupname.component
のようにピリオドで区切られたリストです。class_name
— 作成するクラスの名前を指定します。クラス名を指定しない場合、mcc
はpackage_name
内の最後の項目を使用します。
mcc -W 'java:
は、指定されたファイルから、複数のクラスをもつ Java パッケージを作成します。引数 package_name
,class_name
' [options] 'class{class_name:mfilename1,mfilename2,...,mfilenameN}
'class{___}
を追加して、追加のクラス指定子を含めることができます。
また、関数 compiler.build.javaPackage
(MATLAB Compiler SDK) ではほとんどの一般的なワークフローがサポートされています。
C 共有ライブラリ
MATLAB Compiler SDK が必要です。
mcc -l [options]
は、リストされた関数を C 共有ライブラリにコンパイルし、他のアプリケーションと統合するための C ラッパー コードを生成します。mfilename1 mfilename2 ... mfilenameN
また、関数 compiler.build.cSharedLibrary
(MATLAB Compiler SDK) ではほとんどの一般的なワークフローがサポートされています。
C++ 共有ライブラリ
MATLAB Compiler SDK が必要です。
mcc -W 'cpplib:
は、リストされた関数を C++ 共有ライブラリにコンパイルし、他のアプリケーションと統合するための C++ ラッパー コードを生成します。library_name
[,{all|legacy|generic}]' [options] mfilename1 mfilename2 ... mfilenameN
library_name
— 共有ライブラリの名前を指定します。all
—mwArray
API と MATLAB データ API を使用する汎用インターフェイスの両方を使用して、共有ライブラリを生成します。これは既定の動作です。legacy
—mwArray
API を使用して共有ライブラリを生成します。generic
— MATLAB データ API を使用して共有ライブラリを生成します。
また、関数 compiler.build.cppSharedLibrary
(MATLAB Compiler SDK) ではほとんどの一般的なワークフローがサポートされています。
COM コンポーネント
MATLAB Compiler SDK が必要です。
mcc -W 'com:
は、リストされた関数をコンパイルして汎用 Microsoft COM コンポーネントにします。component_name
,class_name
' [options] mfilename1 mfilename2 ... mfilenameN
component_name
— COM コンポーネントの名前を指定します。
class_name
— クラスの名前を指定します。
また、関数 compiler.build.comComponent
(MATLAB Compiler SDK) ではほとんどの一般的なワークフローがサポートされています。
mcc -W 'com:component_name,
は、指定されたファイルから、複数のクラスをもつ Microsoft COM コンポーネントを作成します。引数 class_name
' [options] 'class{class_name:mfilename1,mfilename2,...,mfilenameN}
'class{___}
を追加して、追加のクラス指定子を含めることができます。
MATLAB Production Server 用のデプロイ可能なアーカイブ
MATLAB Compiler SDK が必要です。
mcc -U -W 'CTF:
は、MATLAB Production Server インスタンスで使用するためのデプロイ可能なアーカイブ (archive_name
[,DISCOVERY:FunctionSignatures.json
][,ROUTES:ArchiveRoutes.json
]' [options] mfilename1 mfilename2 ... mfilenameN
.ctf
ファイル) を作成します。
archive_name
— デプロイ可能なアーカイブの名前を指定します。FunctionSignatures.json
— MATLAB 関数に関する情報が含まれた JSON ファイルを指定します。絶対パスまたは相対パスとして指定します。このオプションは、ディスカバリー API を使用した RESTful クライアントにのみ関係します。詳細については、JSON での MATLAB 関数シグネチャ (MATLAB Production Server)を参照してください。ArchiveRoutes.json
— アーカイブ内の MATLAB Web ハンドラー関数にクライアント リクエストをマッピングする URL ルートが含まれた JSON ファイルを指定します。このオプションは、すべてのルートをroutes-file
(MATLAB Production Server) サーバー構成プロパティで指定されたサーバーレベルのルートファイルで定義する代わりに、デプロイ可能なアーカイブの名前でルートを整理する場合に使用します。Web リクエスト ハンドラーの詳細については、HTTP リクエスト内のカスタムのルートとペイロードの処理 (MATLAB Production Server)を参照してください。
この構文は、Microsoft Excel アドイン用のサーバー側のデプロイ可能なアーカイブ (.ctf
ファイル) も作成します。
また、関数 compiler.build.productionServerArchive
(MATLAB Compiler SDK) ではほとんどの一般的なワークフローがサポートされています。ただし、アーカイブ固有のルートの作成はサポートされていません。
MATLAB Production Server 用 Excel アドイン
MATLAB Compiler SDK が必要です。
mcc -W 'mpsxl:
は、指定されたファイルからクライアント側の Microsoft Excel アドインを作成します。これは、Excel から MATLAB Production Server へのリクエストの送信に使用できます。クライアント側のアドインを作成する前に、指定されたファイルからサーバー側のデプロイ可能なアーカイブ (addin_name
,class_name
,version
' input_marshaling_flags
output_marshaling_flags
[options] mfilename1 mfilename2 ... mfilenameN
.ctf
ファイル) を作成する "必要があります"。クライアント側のアドインだけでは機能しません。
addin_name
— アドインの名前を指定します。class_name
— 作成するクラスの名前を指定します。クラス名を指定しない場合、mcc
はaddin_name
を既定値として使用します。version
—major
.minor
として指定されているアドインのバージョンを指定します。major
— メジャー バージョン番号を指定します。バージョン番号を指定しない場合、mcc
は最新バージョンを使用します。minor
— マイナー バージョン番号を指定します。バージョン番号を指定しない場合、mcc
は最新バージョンを使用します。
input_marshaling_flags
— Microsoft Excel と MATLAB の間でデータがマーシャリングされる方法のオプションを指定します。-replaceBlankWithNaN
— Microsoft Excel の空白が MATLAB では NaN にマーシャリングされることを指定します。このフラグを指定しない場合、空白は 0 にマーシャリングされます。-convertDateToString
— Microsoft Excel の日付が MATLAB の文字ベクトルにマーシャリングされることを指定します。このフラグを指定しない場合、日付は MATLAB の double にマーシャリングされます。
output_marshaling_flags
— MATLAB と Microsoft Excel の間でデータがマーシャリングされる方法のオプションを指定します。-replaceNaNWithZero
— MATLAB の NaN が Microsoft Excel で 0 にマーシャリングされることを指定します。このフラグを指定しない場合、NaN は Visual Basic® で#QNAN
にマーシャリングされます。-convertNumericToDate
— MATLAB の数値が Microsoft Excel の日付にマーシャリングされることを指定します。このフラグを指定しない場合、Microsoft Excel は日付を出力として受け取りません。
また、関数 compiler.build.excelClientForProductionServer
(MATLAB Compiler SDK) ではほとんどの一般的なワークフローがサポートされています。
例
入力引数
制限
mcc
では Web アプリを作成できません。Web アプリを作成するには、Web アプリ コンパイラ アプリまたは関数compiler.build.webAppArchive
を使用します。mcc
を使用して、Linux 環境として機能する MATLAB Online Server™ のコンポーネントをビルドできます (R2022b 以降)。Java、C++、COM コンポーネントなど、外部コンパイラを必要とするターゲットをビルドするには、必要なツールチェーンを実行するように MATLAB Online Server ワーカーを設定する必要があります。
ヒント
Windows では、
mcc
構文を生成するターゲットにversion=
version_number
を追加することにより、ターゲット ファイルのシステム レベル ファイルのバージョン番号を生成できます。例については、Excel アドインの作成 (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 の C 共有ライブラリ、C++ 共有ライブラリ、COM コンポーネント、.NET アセンブリ、および MATLAB Production Server 用 Excel アドインでサポートされています。
バージョン履歴
R2006a より前に導入