スタンドアロン アプリケーション コンパイラ

デプロイする MATLAB プログラムをスタンドアロン アプリケーションとしてパッケージ化する

R2025a 以降

説明

スタンドアロン アプリケーション コンパイラ は、MATLAB^® プログラムを MATLAB 外部で実行できるアプリケーションにパッケージ化します。コンパイラ アプリで使用される対話型のメニューおよびダイアログ ボックスにより、仕様に合わせてカスタマイズされた compiler.build コマンドが作成されます。

コンパイラ アプリには次のような利点があります。

• 単一の直感的なインターフェイスを使用して、デプロイ タスクを実行できる。

• MATLAB プロジェクトでファイルを整理できる。

• プロジェクトの状態がセッション間で維持される。

• 事前に設定されたメニューから、以前保存したコンパイラ タスクを読み込むことができる。

• 配布用にアプリケーションをインストーラーと共にパッケージ化できる。

詳細については、MATLAB コードのデプロイ用のターゲット固有のコンパイラ アプリを参照してください。

スタンドアロン アプリケーション コンパイラ アプリを開く

• MATLAB ツールストリップ: [アプリ] タブの [アプリケーションのデプロイ] にあるアプリのアイコンをクリックします。

• MATLAB コマンド プロンプト: 「standaloneApplicationCompiler」と入力します。

例

• スタンドアロン アプリケーション コンパイラ アプリを使用したスタンドアロン アプリケーションの作成

パラメーター

メイン ファイル

メイン ファイル — MATLAB ファイル

MATLAB 関数を実装するファイル。ファイルの拡張子は .m、.p、.mlx、.mexa64 のいずれかである必要があります。

プロジェクトに追加するすべてのファイルは、プロジェクトのルート フォルダーに配置する必要があります。デプロイ可能なアーカイブに MATLAB 関数を追加するには、[メイン ファイルの追加] をクリックして MATLAB ファイルを選択します。[プロジェクト] パネルでは、選択したファイルに Design と Main File というラベルが付けられます。

アプリケーション情報

アプリケーション名 — アプリケーションの名前

My Desktop Application (既定値)

生成されたアプリケーションの名前。

バージョン — インストールされるアプリケーションのバージョン

1.0.0 (既定値)

アプリケーションのバージョン番号。

作成者名 — 作成者の名前

string

アプリケーションの作成者の名前。

電子メール — 電子メール アドレス

string

アプリケーション作成者の電子メール アドレス。

会社 — 会社名

string

アプリケーションを作成した会社の名前。

概要 — アプリケーションの概要説明

string

アプリケーションの概要説明。文字ベクトルまたは string スカラーとして指定します。

説明 — アプリケーションの詳細な説明

string

アプリケーションの詳細な説明。文字ベクトルまたは string スカラーとして指定します。

出力場所

ビルドの出力フォルダー — デプロイ可能なアーカイブが生成されるフォルダーへのパス

[project root]\<task_name>\output\build (既定値)

ビルド アーティファクトが生成されるフォルダーへのパス。

インストーラーの出力フォルダー — インストーラーが生成されるフォルダーへのパス

[project root]\<task_name>\output\package (既定値)

インストーラーが生成されるフォルダーへのパス。

実行可能ファイルの詳細

実行可能ファイル名 — アプリケーションの実行可能ファイルの名前

MyDesktopApplication (既定値)

生成されたアプリケーションの実行可能ファイルの名前。

アプリケーション タイプ — アプリケーションのプラットフォーム

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

アプリケーションのプラットフォームおよび動作。次のいずれかのオプションとして指定します。

• スタンドアロン アプリケーション — 実行時に Windows^® コマンド シェルを開くスタンドアロン アプリケーションを作成します。実行可能ファイルのタイプは、アプリケーションがビルドされるプラットフォームによって異なります。

• スタンドアロン Windows アプリケーション — MATLAB 関数、クラス、または AppFile を使って指定されたアプリを用いて、スタンドアロンの Windows 専用アプリケーションを作成します。このアプリケーションは実行時に Windows コマンド シェルを開かず、その結果コンソール出力は表示されません。このオプションは Windows でのみ使用できます。

入力タイプ — コマンド ライン入力を解釈

アプリへの入力を MATLAB 文字ベクトルとして扱う (既定値) | アプリへの入力を MATLAB double の数値として扱う

コマンド ライン入力を数値または文字ベクトルとして解釈します。

• アプリへの入力を MATLAB 文字ベクトルとして扱う — コマンド ライン入力は MATLAB 文字ベクトルとして扱われます。これは既定の動作です。

• アプリへの入力を MATLAB double の数値として扱う — コマンド ライン入力は MATLAB double の数値として扱われます。

コードの難読化 — デプロイ可能なアーカイブを難読化

オフ (既定値) | オン

デプロイ可能なアーカイブ内でフォルダー構造、ファイル名、およびユーザー コードを難読化します。

このプロパティを有効にした場合、デプロイ可能なアーカイブのフォルダー構造およびファイル名はエンド ユーザーに対して難読化され、.m、.mlapp、.p、.mat、MLX、SFX、および MEX ファイルに含まれているユーザー コードおよびデータはアーカイブ内のユーザー パッケージに配置されます。また、すべての .m ファイルがパッケージ化の前に P ファイルに変換されます。

実行時に、MATLAB コードとデータはファイル システムに抽出されるのではなく、ユーザー パッケージから直接復号化されて読み込まれます。MEX ファイルは、一時的にユーザー パッケージから抽出されてから、読み込まれます。

追加のファイル タイプをユーザー パッケージに手動で含めるには、それぞれのファイル タイプを個別の拡張子タグでファイル matlabroot/toolbox/compiler/advanced_package_supported_files.xml に追加します。

以下はサポートされて "いません"。

• ver 関数

• DLL などの外部ライブラリの呼び出し

• アウトプロセスの MATLAB Runtime (MATLAB データ配列の C++ 共有ライブラリ)

• アウトプロセスでの MEX ファイルの実行 (mexhost、feval、matlab.mex.MexHost)

• R2023b より前: v7.3 以外の .mat ファイル

このオプションを有効にすることは、-j および -s を指定して mcc を使用するのと等価です。

このプロパティを有効にしない場合、デプロイ可能なアーカイブは難読化されません。これは既定の動作です。

スプラッシュ スクリーン — スプラッシュ スクリーン イメージ

イメージ

アプリケーションのスプラッシュ スクリーンとして使用するイメージ ファイル。文字ベクトルまたは string スカラーとして指定します。スプラッシュ スクリーンのアイコンのサイズは 400 x 400 ピクセルに変更されます。

アイコン — アイコン イメージ

イメージ

アプリケーションのアイコンとして使用するイメージ ファイル。

アイコン

アプリケーションの実行に必要なファイル

必須サポート パッケージ — 含めるサポート パッケージ

サポート パッケージのリスト

デプロイ可能なアーカイブに含めるサポート パッケージ。依存関係の分析プロセスにより、必要なサポート パッケージが自動的に検出され、含められます。指定されたサポート パッケージのみが含められます。インストールされている、または特定のファイルで使用されるサポート パッケージのリストを表示するには、compiler.codetools.deployableSupportPackages を参照してください。

カスタム要件 — 含める追加のファイルとフォルダー

ファイルのリスト

デプロイ可能なアーカイブに含める追加のファイルとフォルダー。フォルダーの内容を追加するには、[フォルダーの追加] をクリックします。個々のファイルを追加するには、[ファイルの追加] をクリックします。

検出された要件 — パッケージの詳細な説明

ファイルのリスト

デプロイ可能なアーカイブに含める追加のファイル。[load や fopen などの関数への入力として提供されるデータ ファイルを自動的に含める] が無効になっていない限り、必要なデータ ファイルが依存関係の分析プロセスによって自動的に検出されて含まれます。

ファイルの解析結果を確認するには、[解析の表示] をクリックします。依存関係の分析プロセスを再度実行するには、[再解析] をクリックします。

load や fopen などの関数への入力として提供されるデータ ファイルを自動的に含める — データ ファイルを自動的に含める

オン (既定値) | オフ

デプロイ可能なアーカイブにデータ ファイルを自動的に含めます。

• このプロパティを有効にした場合、特定の関数 (load や fopen など) への入力として指定したデータ ファイルは自動的にデプロイ可能なアーカイブに含められます。これは既定のオプションです。

• このプロパティを無効にした場合、[カスタム要件] セクションでデータ ファイルをパッケージに追加する必要があります。

インストーラーの詳細

パッケージ タイプ — MATLAB Runtime の引き渡し

アプリケーションのインストール時に mathworks.com から MATLAB Runtime を取得します。 (既定値) | オフライン インストール用のアプリケーション インストーラーに MATLAB Runtime を含めます。 | MATLAB Runtime をアプリケーション インストーラーに含めません。

MATLAB Runtime の引き渡しオプション。次のいずれかとして指定します。

• アプリケーションのインストール時に mathworks.com から MATLAB Runtime を取得します — アプリケーションのインストール時にインストーラーが MathWorks^® の Web サイトから MATLAB Runtime をダウンロードするオプション。このオプションは既定の動作です。

• オフライン インストール用のアプリケーション インストーラーに MATLAB Runtime を含めます — アプリケーションのインストール時に MathWorks Web サイトに接続せずにインストールできるように、インストーラー内に MATLAB Runtime を含めるオプション。エンド ユーザーがインターネットにアクセスできない可能性があると考えられる場合は、このオプションを使用します。

• MATLAB Runtime をアプリケーション インストーラーに含めません — アプリケーションのインストール時に MATLAB Runtime をインストールしないオプション。エンド ユーザーが別の方法を使用して MATLAB Runtime をインストールすると考えられる場合は、このオプションを使用します。 (R2024a 以降)

メモ

取得オプションと含めるオプションのいずれかを使用すると、完全な MATLAB Runtime がインストールされます。1 つ以上の特定の MATLAB Runtime アプリケーションを実行できる最小限の MATLAB Runtime インストーラーを作成するには、compiler.runtime.customInstaller を参照してください。 (R2024b 以降)

インストーラー名 — MATLAB ファイル

MyAppInstaller (既定値) | string

生成されたインストーラーの名前。

既定のインストール場所 — アプリケーションがインストールされるフォルダーへのパス

%ProgramFiles%\<application_name> (既定値)

アプリケーションがインストールされるフォルダーへのパス。フォルダーはターゲット マシンの %ProgramFiles% フォルダー内にあります。

インストーラー メモ — インストーラーのメモ

string

アプリケーションの使用に関する追加要件についてのメモ。

スプラッシュ スクリーン — スプラッシュ スクリーン イメージ

イメージ

インストーラーのスプラッシュ スクリーンとして使用するイメージ ファイル。文字ベクトルまたは string スカラーとして指定します。スプラッシュ スクリーンのアイコンのサイズは 400 x 400 ピクセルに変更されます。

アイコン — アイコン イメージ

イメージ

インストーラーのアイコンとして使用するイメージ ファイル。

サイドバー イメージ — インストーラー イメージ

文字ベクトル | string スカラー

インストーラーのロゴとして使用するイメージ ファイル。文字ベクトルまたは string スカラーとして指定します。ロゴのサイズは 112 x 290 ピクセルに変更されます。

バージョン履歴

R2025a で導入

R2025a: アプリのエントリ ポイントの変更

R2024b 以前のリリースでは、アプリケーション コンパイラを使用してスタンドアロン アプリケーションを生成できます。R2025a 以降では、スタンドアロン アプリケーション コンパイラ を使用してスタンドアロン アプリケーションを作成します。

R2025a: 出力フォルダー名の変更

R2024b 以前のリリースでは、コンパイラ アプリは for redistribution、for redistribution_files_only、および for testing の各フォルダーに出力ファイルを生成します。R2025a 以降では、コンパイラ アプリはコンパイラ タスクに従って名付けられたフォルダーに出力ファイルを生成します。

参考

アプリ

関数

• compiler.build.standaloneApplication | compiler.build.standaloneWindowsApplication