compiler.runtime.customInstaller

MATLAB Compiler により生成される指定されたファイルの MATLAB Runtime インストーラーを作成する

R2024b 以降

構文

compiler.runtime.customInstaller(installerName, results)

compiler.runtime.customInstaller(installerName, filepath)

compiler.runtime.customInstaller(___,Name=Value)

説明

compiler.runtime.customInstaller(installerName, results) は、MATLAB^® Compiler™ または MATLAB Compiler SDK™ で作成された指定のアーティファクトを実行するために必要な MATLAB Runtime コンポーネントだけをインストールする、フットプリントが最小限のサイズの MATLAB Runtime インストーラーを作成します。任意の compiler.build 関数によって作成された 1 つ以上の compiler.build.Results オブジェクトのベクトルである results を使用してアーティファクトを指定します。

compiler.runtime.customInstaller(installerName, filepath) は、MATLAB Compiler によって生成された requiredMCRProducts.txt ファイルのリストを使用して MATLAB Runtime インストーラーを作成します。

compiler.runtime.customInstaller(___,Name=Value) は、1 つ以上の名前と値の引数として指定された追加オプションを使用して MATLAB Runtime インストーラーを作成します。オプションには、出力フォルダー、パッケージ タイプ、ランタイムの引き渡し方法が含まれます。

例

ビルド結果を使用した MATLAB Runtime インストーラーの作成

スタンドアロン アプリケーションを実行するために必要なすべての MATLAB Runtime コンポーネントをインストールする最小限の MATLAB Runtime インストーラーを作成します。

スタンドアロン アプリケーションにパッケージ化する MATLAB 関数を記述します。この例では、ファイル magicsquare.m を使用してコンパイルします。

copyfile(fullfile(matlabroot,"extern","examples","compiler","magicsquare.m"));

compiler.build.standaloneApplication を使用してスタンドアロン アプリケーションを作成します。関数からの出力を compiler.build.Results オブジェクトとして保存します。

results = compiler.build.standaloneApplication("magicsquare.m");

スタンドアロン アプリケーションを実行するために必要なコンポーネントを含む MATLAB Runtime インストーラーを作成します。

compiler.runtime.customInstaller("magicsquareInstaller",results);

スタンドアロン アプリケーションと生成された MATLAB Runtime インストーラーをターゲット マシンにデプロイします。

インストールされる MATLAB Runtime は、MATLAB Runtime の完全インストールよりも占有する容量が少なくなります。

オフライン マシンで MATLAB Runtime インストーラーを作成する

MATLAB Runtime のフル インストーラーを使用して、オフライン マシンで最小限の MATLAB Runtime インストーラーを作成します。

インターネットに接続されたマシンを使用して、オフライン マシンの MATLAB リリース用の MATLAB Runtime フル インストーラーをダウンロードします。詳細については、MATLAB Runtime のダウンロードとインストール (MATLAB Compiler SDK)を参照してください。インストーラーをオフライン マシンに移します。

オフライン マシンの MATLAB で、[基本設定] メニューを開き、[MATLAB Compiler] を選択します。MATLAB Runtime インストーラーの場所を指定します。

オフライン マシンで、スタンドアロン アプリケーションにパッケージ化する MATLAB 関数を記述します。この例では、ファイル magicsquare.m を使用してコンパイルします。

copyfile(fullfile(matlabroot,"extern","examples","compiler","magicsquare.m"));

compiler.build.standaloneApplication を使用してスタンドアロン アプリケーションを作成します。関数からの出力を compiler.build.Results オブジェクトとして保存します。

results = compiler.build.standaloneApplication("magicsquare.m");

スタンドアロン アプリケーションを実行するために必要なコンポーネントを含む MATLAB Runtime インストーラーを作成します。

compiler.runtime.customInstaller("magicsquareInstaller",results);

スタンドアロン アプリケーションと生成された MATLAB Runtime インストーラーをターゲット マシンにデプロイします。

ファイルを使用した MATLAB Runtime インストーラーの作成

MATLAB Compiler によって生成された requiredMCRProducts.txt ファイルを使用して、Windows^® で MATLAB Runtime インストーラーを作成します。

スタンドアロン Windows アプリケーションにパッケージ化する MATLAB 関数を記述します。この例では、MATLAB スクリプト flames.m およびデータ ファイル flames.mat を現在の作業ディレクトリにコピーします。

copyfile(fullfile(matlabroot,"extern","examples","compiler","flames.*"));

mcc を使用して、flames.m を使用するスタンドアロン Windows アプリケーションを作成します。

mcc("flames.m","-e","-a","flames.mat","-d","flames")

houdini.m ファイルを使用して Excel^® アドインを作成します。

copyfile(fullfile(matlabroot,"extern","examples","compiler","houdini.m"));
compiler.build.excelAddIn("houdini.m","GenerateVisualBasicFile","on","OutputDir","houdini");

スタンドアロン アプリケーションと Excel アドインの両方を実行するために必要なコンポーネントを含む MATLAB Runtime インストーラーを作成します。

compiler.runtime.customInstaller("flames_houdiniInstaller",...
["flames\requiredMCRProducts.txt","houdini\requiredMCRProducts.txt"]);

flames_houdiniInstaller.exe という名前の MATLAB Runtime インストーラーが flames_houdiniInstaller フォルダー内に生成されます。

名前と値の引数を使用して MATLAB Runtime インストーラーをカスタマイズする

複数の C++ 共有ライブラリを実行するために必要なすべての MATLAB Runtime コンポーネントをインストールする MATLAB Runtime インストーラーを作成します。

この例では、MATLAB に付属している matrix フォルダーを作業フォルダーにコピーします。

copyfile(fullfile(matlabroot,"extern","examples","compilersdk","c_cpp","matrix"),"matrix")

作業フォルダー内の新しい matrix サブフォルダーに移動します。

compiler.build.cppSharedLibrary を使用して 2 つの C++ 共有ライブラリを作成します。

functionfiles = {"addmatrix.m", "multiplymatrix.m", "eigmatrix.m"};

results1 = compiler.build.cppSharedLibrary(functionfiles,...
"OutputDir","matrixLibraries");

results2 = compiler.build.cppSharedLibrary("subtractmatrix.m",...
"OutputDir","matrixLibraries");

すべてのライブラリに使用できる MATLAB Runtime インストーラーを作成します。名前と値の引数を使用してビルド フォルダーを指定し、オフライン デプロイ用のインストーラーに MATLAB Runtime を組み込みます。

compiler.runtime.customInstaller("matrixInstaller",[results1,results2],...
OutputDir="customInstallers",RuntimeDelivery="installer")

インストーラー matrixInstaller.zip は現在の作業ディレクトリにある customInstallers フォルダーに生成されます。

MATLAB Runtime インストーラーおよび共有ライブラリ ファイル (.ctf および .hpp) をターゲット マシンにデプロイします。

入力引数

installerName — インストーラー ファイルの名前

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

インストーラー ファイルの名前。文字ベクトルまたは string スカラーとして指定します。拡張子は、関数が実行されるオペレーティング システムによって決まります。

例: "MagicSquare_Installer"

results — ビルド結果

compiler.build.Results オブジェクトのベクトル

compiler.build.standaloneApplication や compiler.build.productionServerArchive (MATLAB Compiler SDK) などの compiler.build 関数により作成された 1 つ以上のビルド結果。compiler.build.Results オブジェクトのベクトルとして指定します。

例: [results1,results2]

filepath — requiredMCRProducts.txt へのパス

文字ベクトル | string スカラー | string 配列 | string の cell 配列

requiredMCRProducts.txt への 1 つ以上のパス。このファイルは MATLAB Compiler または MATLAB Compiler SDK により生成されます。

例: ["fun1/requiredMCRProducts.txt","fun2/requiredMCRProducts.txt"]

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: PackageType="zip"

OptionalDependencies — 含めるオプションの依存関係

"all" (既定値) | "none"

R2025a 以降

インストーラーに含めるオプションの MATLAB Runtime 依存関係。次のいずれかとして指定します。

• "all" — すべてのオプションの依存関係をインストーラーに含めるオプション。グラフィカル サポートを含みます。このオプションは既定の動作です。

• "none" — オプションの依存関係をインストーラーに含めないオプション。このオプションを使用して、生成されるインストーラーのサイズを最小化します。

例: OptionalDependencies="none"

OutputDir — 出力ディレクトリへのパス

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

インストーラーの保存先の出力ディレクトリへのパス。文字ベクトルまたは string スカラーとして指定します。このパスは現在の作業ディレクトリを基準とした相対パス、または絶対パスにできます。

出力フォルダーの既定の名前は installerName の値です。

例: OutputDir="D:\Documents\MATLAB\work\myappInstaller"

データ型: char | string

PackageType — インストーラーのファイル タイプ

"auto" (既定値) | "zip"

インストーラーのファイル タイプ。次のいずれかのオプションとして指定します。

• "auto" — インストーラーの作成時に適切なファイル タイプをインストーラーで自動的に選択するオプション。インストーラーのサイズが 2 GB 以上の場合、インストーラーは ZIP ファイルとしてパッケージ化されます。これは既定のオプションです。

• "zip" — 新しいインストーラーの作成時に ZIP ファイルを出力として常に生成するオプション。このオプションは RuntimeDelivery が "installer" に設定されている場合のみサポートされています。このオプションは Windows システムでのみサポートされています。

例: PackageType="zip"

データ型: char | string

RuntimeDelivery — MATLAB Runtime の引き渡し方法

"web" (既定値) | "installer"

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

• "web" — アプリケーションのインストール時にインストーラーが MathWorks^® の Web サイトから MATLAB Runtime をダウンロードするオプション。これは既定のオプションです。

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

例: RuntimeDelivery="installer"

データ型: char | string

ヒント

• この関数で作成されたインストーラーは、最小限のサイズのフットプリントで MATLAB Runtime コンポーネントのサブセットをインストールします。MATLAB Runtime のフル インストーラーをダウンロードするには、compiler.runtime.download を参照してください。

• この関数で作成された複数のインストーラーを使用する場合、MATLAB Runtime はすべてのインストーラーにわたるコンポーネントの最小限のサブセットを含むように更新されます。つまり、各ビルドによって作成されたカスタム インストーラーを使用して、MATLAB Runtime の同じインスタンスで、MATLAB Compiler によって生成された複数のアーティファクトを実行できます。

• この関数で作成されたインストーラーは、MATLAB Compiler により生成されたアーティファクトをインストールしません。パッケージ化された MATLAB コード用のインストーラーを作成するには、compiler.package.installer を参照してください。

バージョン履歴

R2024b で導入

R2025a: オプションの依存関係

OptionalDependencies オプションを使用して、すべてのオプションの MATLAB Runtime 依存関係をインストーラーに含めるかどうかを制御できます。

参考

compiler.package.installer | compiler.build.Results | mcc