compiler.build.standaloneWindowsApplication
Windows コマンド シェルを起動しない、MATLAB 外部でのデプロイ用スタンドアロン アプリケーションの作成
構文
説明
注意
この関数は Windows® オペレーティング システムでのみサポートされています。
compiler.build.standaloneWindowsApplication( は、MATLAB® 関数、クラス、または AppFile)AppFile を使って指定されたアプリを用いて、スタンドアロンの Windows 専用アプリケーションを作成します。このアプリケーションは実行時に Windows コマンド シェルを開かず、その結果コンソール出力は表示されません。生成された実行可能ファイルには .exe ファイル拡張子があり、MATLAB Runtime やインストーラーは含まれていません。
compiler.build.standaloneWindowsApplication( は、名前と値の引数を 1 つ以上使って指定した追加オプションを用いて、スタンドアロンの Windows アプリケーションを作成します。オプションには実行可能ファイルの名前、バージョン番号、アイコン、スプラッシュ イメージが含まれます。AppFile,Name,Value)
compiler.build.standaloneWindowsApplication( は、opts)compiler.build.StandaloneApplicationOptions オブジェクト opts を使って指定した追加オプションを用いて、スタンドアロンの Windows アプリケーションを作成します。名前と値の引数を使用して他のオプションを指定することはできません。
例
プロットを表示するグラフィカル スタンドアロン アプリケーションを Windows システム上で作成します。
1 ～ 10 の値をプロットする MATLAB 関数を記述します。この関数を myPlot.m という名前のファイルに保存します。
function myPlot()
plot(1:10)compiler.build.standaloneWindowsApplication コマンドを使用して、スタンドアロンの Windows アプリケーションをビルドします。
compiler.build.standaloneWindowsApplication('myPlot.m');
この構文により、現在の作業ディレクトリの myPlotstandaloneApplication という名前のフォルダー内に以下のファイルが生成されます。
includedSupportPackages.txt— アプリケーションに含まれている、すべてのサポートされるファイルをリストしたテキスト ファイル。myPlot.exe— 実行可能ファイル。mccExcludedFiles.log— アプリケーションに含まれていないすべてのツールボックス関数のリストが含まれるログ ファイル。サポートされていない関数の詳細については、MATLAB Compiler の制限を参照してください。readme.txt— デプロイの前提条件に関する情報と、デプロイ用にパッケージ化するファイルのリストが含まれる Readme ファイル。requiredMCRProducts.txt— MATLAB Runtime がアプリケーションを実行するために必要な製品の製品 ID が含まれるテキスト ファイル。splash.png— アプリケーションの起動時に表示されるスプラッシュ イメージが含まれるファイル。unresolvedSymbols.txt— 未解決のシンボルがすべて含まれるテキスト ファイル。
myPlot.exe を実行するには、myPlotstandaloneApplication フォルダーに移動し、ファイル ブラウザーで myPlot.exe をダブルクリックするか、MATLAB コマンド ウィンドウで !myPlot を実行するか、または Windows コマンド シェルで myPlot.exe を実行します。
アプリケーションによりスプラッシュ イメージが表示され、その後にライン プロットの MATLAB Figure が表示されます。
Figure 1 (myPlot.exe)
Windows システム上でグラフィカル スタンドアロン アプリケーションを作成し、名前と値の引数を使用してカスタマイズします。
xVal を、0 と 2π の間の線形に配置された値のベクトルとして作成します。値の間には π/40 のインクリメントを使用します。yVal を x の正弦値として作成します。両方の変数を myVars.mat という名前の MAT ファイルに保存します。
xVal = 0:pi/40:2*pi; yVal = sin(xVal); save('myVars.mat','xVal','yVal');
myPlot.m という名前の関数ファイルを作成し、xVal および yVal の各変数のライン プロットを作成します。
function myPlot() load('myVars.mat'); plot(xVal,yVal)
compiler.build.standaloneWindowsApplication 関数を使用してスタンドアロン アプリケーションをビルドします。名前と値の引数を使用して、実行可能ファイルの名前とバージョン番号を指定します。
compiler.build.standaloneWindowsApplication('myPlot.m', ... 'ExecutableName','SineWaveApp',... 'ExecutableVersion','2.0')
この構文により、現在の作業ディレクトリの SineWaveAppstandaloneApplication という名前のフォルダー内に以下のファイルが生成されます。
includedSupportPackages.txtmccExcludedFiles.logreadme.txtrequiredMCRProducts.txtSineWaveApp.exesplash.pngunresolvedSymbols.txt
SineWaveApp.exe を実行するには、myPlotstandaloneApplication フォルダーに移動し、ファイル ブラウザーで SineWaveApp.exe をダブルクリックするか、MATLAB コマンド ウィンドウで !SineWaveApp.exe を実行するか、または Windows コマンド プロンプトで SineWaveApp.exe を実行します。
アプリケーションによりスプラッシュ イメージが表示され、その後に正弦波の MATLAB Figure が表示されます。
Figure 1 (SineWaveApp.exe)
compiler.build.StandaloneApplicationOptions オブジェクトを使用して、Windows システム上で複数のグラフィカル スタンドアロン アプリケーションを作成します。
1 ～ 10 の値をプロットする MATLAB 関数を記述します。この関数を myPlot.m という名前のファイルに保存します。
function myPlot()
plot(1:10)
myPlot.m を使用して StandaloneApplicationOptions オブジェクトを作成します。名前と値の引数を使用して共通の出力ディレクトリを指定し、ビルド プロセス中に進行状況の情報を表示します。
opts = compiler.build.StandaloneApplicationOptions('myPlot.m', ... 'OutputDir','D:\Documents\MATLAB\work\WindowsApps', ... 'Verbose','On')
opts =
StandaloneApplicationOptions with properties:
CustomHelpTextFile: ''
EmbedArchive: on
ExecutableIcon: 'C:\Program Files\MATLAB\R2025b\toolbox\compiler\packagingResources\default_icon_48.png'
ExecutableName: 'myPlot'
ExecutableSplashScreen: 'C:\Program Files\MATLAB\R2025b\toolbox\compiler\packagingResources\default_splash.png'
ExecutableVersion: '1.0.0.0'
AppFile: 'myPlot.m'
TreatInputsAsNumeric: on
AdditionalFiles: {}
AutoDetectDataFiles: on
ExternalEncryptionKey: [0×0 struct]
ObfuscateArchive: off
SecretsManifest: ''
SupportPackages: {'autodetect'}
Verbose: on
OutputDir: 'D:\Documents\MATLAB\work\WindowsApps'StandaloneApplicationOptions オブジェクトを入力としてビルド関数に渡すことで、グラフィカル スタンドアロン アプリケーションをビルドします。
compiler.build.standaloneWindowsApplication(opts);
同じオプションをもつ関数ファイル myPlot2.m を使用して新しいアプリケーションを作成するには、ビルド関数を再度実行する前に、ドット表記を使用して既存の StandaloneApplicationOptions オブジェクトの AppFile を変更します。
opts.AppFile = 'example2.m';
compiler.build.standaloneWindowsApplication(opts);AppFile 引数を変更して再コンパイルすることにより、同じオプション オブジェクトを使用して複数のアプリケーションをコンパイルできます。
スタンドアロンの Windows アプリケーションを Windows システムで作成し、ビルド タイプ、生成ファイル、含まれるサポート パッケージ、およびビルド オプションに関する情報を compiler.build.Results オブジェクトに保存します。
ファイル Mortgage.mlapp を使用してコンパイルします。
results = compiler.build.standaloneWindowsApplication('Mortgage.mlapp')results =
Results with properties:
BuildType: 'standaloneWindowsApplication'
Files: {3×1 cell}
IncludedSupportPackages: {}
Options: [1×1 compiler.build.StandaloneApplicationOptions]
RuntimeDependencies: [1×1 compiler.runtime.Dependencies]Files プロパティには、以下のファイルへのパスが格納されます。
Mortgage.exesplash.pngreadme.txt
入力引数
名前と値の引数
出力引数
制限
この関数は Windows オペレーティング システムでのみサポートされています。
このアプリケーションは実行時に Windows コマンド シェルを開かず、その結果コンソール出力は表示されません。
ヒント
この関数を使用してシステム コマンド プロンプトから Windows スタンドアロン アプリケーションを作成するには、関数
matlabを-batchオプションと共に使用します。以下に例を示します。matlab -batch compiler.build.standaloneWindowsApplication('myapp.mlapp')
