compiler.package.InstallerOptions

MATLAB Compiler パッケージインストーラーの作成オプション

構文

opts = compiler.package.InstallerOptions(results)

opts = compiler.package.InstallerOptions(results,Name,Value)

opts = compiler.package.InstallerOptions('ApplicationName',appName)

opts = compiler.package.InstallerOptions('ApplicationName',appName,Name,Value)

説明

opts = compiler.package.InstallerOptions(results) は、関数 compiler.build から生成された compiler.build.Results オブジェクト results を使用して、既定の InstallerOptions オブジェクト opts を作成します。InstallerOptions オブジェクトは、関数 compiler.package.installer に入力として渡されます。

例

opts = compiler.package.InstallerOptions(results,Name,Value) は、compiler.build.Results オブジェクト results と、名前と値の引数を 1 つ以上使用して指定した追加オプションを使って、InstallerOptions オブジェクト opts を作成します。InstallerOptions オブジェクトは、関数 compiler.package.installer に入力として渡されます。

例

opts = compiler.package.InstallerOptions('ApplicationName',appName) は、appName で指定されたアプリケーション名を使用して、既定の InstallerOptions オブジェクト opts を作成します。InstallerOptions オブジェクトは、関数 compiler.package.installer に入力として渡されます。

例

opts = compiler.package.InstallerOptions('ApplicationName',appName,Name,Value) は、appName で指定されたアプリケーション名と、名前と値の引数で指定された追加のカスタマイズを使って、InstallerOptions オブジェクト opts を作成します。InstallerOptions オブジェクトは、関数 compiler.package.installer に入力として渡されます。

例

すべて折りたたむ

結果を使用したインストーラーオプションオブジェクトの作成

関数 compiler.build.standaloneApplication からの結果と、名前と値の引数として指定された追加オプションを使用して、InstallerOptions オブジェクトを作成します。

この例では、matlabroot\extern\examples\compiler にあるファイル magicsquare.m を使用してスタンドアロンアプリケーションをビルドします。

appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
results = compiler.build.standaloneApplication(appFile);

InstallerOptions オブジェクトを作成します。名前と値の引数を使用して、アプリケーション名、作成会社、作成者名、インストーラー名、および概要を指定します。

opts = compiler.package.InstallerOptions(results,...
    'ApplicationName','MagicSquare_Generator',...
    'AuthorCompany','Boston Common',...
    'AuthorName','Frog',...
    'InstallerName','MagicSquare_Installer',...
    'Summary','Generates a magic square.')

opts = 

  InstallerOptions with properties:

           RuntimeDelivery: 'web'
           InstallerSplash: 'C:\Program Files\MATLAB\R2025b\toolbox\compiler\packagingResources\default_splash.png'
             InstallerIcon: 'C:\Program Files\MATLAB\R2025b\toolbox\compiler\packagingResources\default_icon_48.png'
             InstallerLogo: 'C:\Program Files\MATLAB\R2025b\toolbox\compiler\packagingResources\default_logo.png'
           AdditionalFiles: {}
     AddRemoveProgramsIcon: 'C:\Program Files\MATLAB\R2025b\toolbox\compiler\packagingResources\default_icon_48.png'
                AuthorName: 'Frog'
               AuthorEmail: ''
             AuthorCompany: 'Boston Common'
                   Summary: 'Generates a magic square.'
               Description: ''
         InstallationNotes: ''
                  Shortcut: 'D:\Work\magicsquarestandaloneApplication\magicsquare.exe'
                   Version: '1.0'
             InstallerName: 'MagicSquare_Installer'
           ApplicationName: 'MagicSquare_Generator'
                 OutputDir: '.\MagicSquare_Generatorinstaller'
    DefaultInstallationDir: 'C:\Program Files\MagicSquare_Generator'
                   Verbose: 'off'

ドット表記を使用して、既存の InstallerOptions オブジェクトのプロパティ値を変更することができます。たとえば、インストーラー名を MyMagicInstaller に設定します。

opts.InstallerName = 'MyMagicInstaller'

スタンドアロンアプリケーションのインストーラーを作成するには、Results オブジェクトと InstallerOptions オブジェクトを関数 compiler.package.installer への入力として使用します。

compiler.package.installer(results,'Options',opts);

関数は、MagicSquare_Generatorinstaller という名前のフォルダー内に MagicSquare_Installer という名前のインストーラーを生成します。

ドット表記を使用して、既存の InstallerOptions オブジェクトのプロパティ値を変更することができます。たとえば、インストールメモを指定します。

opts.InstallationNotes = 'Windows installer for MagicSquare'

アプリケーション名を使用したインストーラーオプションオブジェクトの作成

アプリケーション名と、名前と値の引数として指定された追加オプションを使って InstallerOptions オブジェクトを作成します。

opts = compiler.package.InstallerOptions('ApplicationName','MagicSquare_Generator',...
    'AuthorCompany','Boston Common',...
    'AuthorName','Frog',...
    'InstallerName','MagicSquare_Installer',...
    'Summary','Generates a magic square.')

opts = 

  InstallerOptions with properties:

           RuntimeDelivery: 'web'
           InstallerSplash: 'C:\Program Files\MATLAB\R2025b\toolbox\compiler\packagingResources\default_splash.png'
             InstallerIcon: 'C:\Program Files\MATLAB\R2025b\toolbox\compiler\packagingResources\default_icon_48.png'
             InstallerLogo: 'C:\Program Files\MATLAB\R2025b\toolbox\compiler\packagingResources\default_logo.png'
           AdditionalFiles: {}
     AddRemoveProgramsIcon: ''
                AuthorName: 'Frog'
               AuthorEmail: ''
             AuthorCompany: 'Boston Common'
                   Summary: 'Generates a magic square.'
               Description: ''
         InstallationNotes: ''
                  Shortcut: ''
                   Version: '1.0'
             InstallerName: 'MagicSquare_Installer'
           ApplicationName: 'MagicSquare_Generator'
                 OutputDir: '.\MagicSquare_Generator'
    DefaultInstallationDir: 'C:\Program Files\MagicSquare_Generator'
                   Verbose: 'off'

入力引数

すべて折りたたむ

`results` — ビルド結果オブジェクト
`Results` オブジェクト

ビルド結果。compiler.build.Results オブジェクトとして指定します。関数 compiler.build からの出力を保存することで、Results オブジェクトを作成します。

`appName` — インストールされるアプリケーションの名前
文字ベクトル | string スカラー

インストールされるアプリケーションの名前。文字ベクトルまたは string スカラーとして指定します。

例: 'MagicSquare_Generator'

データ型: char | string

名前と値の引数

すべて折りたたむ

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

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: "Version","9.5" は、インストールされているアプリケーションのバージョンを指定します。

`AdditionalFiles` — 追加ファイル
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

R2023a 以降

アプリケーションとともにインストールする追加のファイルとフォルダー。文字ベクトル、string スカラー、string 配列、または文字ベクトルの cell 配列として指定します。パスは現在の作業ディレクトリを基準とした相対パス、または絶対パスにできます。

例: "AdditionalFiles",["myimage.png","data.mat"]

データ型: char | string | cell

`AddRemoveProgramsIcon` — [プログラムの追加と削除] アイコン
文字ベクトル | string スカラー | string 配列

R2023a 以降

[プログラムの追加と削除] アイコン。文字ベクトルまたは string スカラーとして指定します。イメージは、設定内の Windows^® アプリケーションのリストでアイコンとして使用されます。パスは現在の作業ディレクトリを基準とした相対パス、または絶対パスにできます。

既定のパスは次のとおりです。

"matlabroot\toolbox\compiler\packagingResources\default_icon_48.png"

例: "AddRemoveProgramsIcon","win_icon.png"

データ型: char | string

`ApplicationName` — アプリケーション名
`""` (既定値) | 文字ベクトル | string スカラー

インストールされるアプリケーションの名前。文字ベクトルまたは string スカラーとして指定します。

例: "ApplicationName","MagicSquare_Generator"

データ型: char | string

`AuthorCompany` — 会社名
`""` (既定値) | 文字ベクトル | string スカラー

アプリケーションを作成した会社名。文字ベクトルまたは string スカラーとして指定します。

例: "AuthorCompany","Boston Common"

データ型: char | string

`AuthorEmail` — 電子メールアドレス
`""` (既定値) | 文字ベクトル | string スカラー

アプリケーション作成者の電子メールアドレス。文字ベクトルまたは string スカラーとして指定します。

例: "AuthorEmail","frog@example.com"

データ型: char | string

`AuthorName` — 名前
`""` (既定値) | 文字ベクトル | string スカラー

アプリケーション作成者の名前。文字ベクトルまたは string スカラーとして指定します。

例: "AuthorName","Frog"

データ型: char | string

`DefaultInstallationDir` — 既定のインストールパス
文字ベクトル | string スカラー

インストーラーがアプリケーションをインストールする既定のディレクトリ。文字ベクトルまたは string スカラーとして指定します。

パスを指定しない場合、各オペレーティングシステムの既定のパスは次のとおりです。

オペレーティングシステム	既定のインストールディレクトリ
Windows	`C:\Program Files\appName`
Linux^®	`/usr/appName`
macOS	`/Applications/appName`

例: "DefaultInstallationDir","C:\Users\MW_Programs\MagicSquare_Generator"

データ型: char | string

`Description` — アプリケーションの詳細な説明
`""` (既定値) | 文字ベクトル | string スカラー

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

例: "Description","The MagicSquare_Generator application generates an n-by-n matrix constructed from the integers 1 through n2 with equal row and column sums."

データ型: char | string

`InstallationNotes` — メモ
`""` (既定値) | 文字ベクトル | string スカラー

アプリケーションの使用に関する追加要件についてのメモ。文字ベクトルまたは string スカラーとして指定します。

例: "InstallationNotes","This is a Linux installer."

データ型: char | string

`InstallerIcon` — アイコンイメージへのパス
文字ベクトル | string スカラー

インストールされるアプリケーションのアイコンとして使用するイメージファイルへのパス。文字ベクトルまたは string スカラーとして指定します。

既定のパスは次のとおりです。

"matlabroot\toolbox\compiler\packagingResources\default_icon_48.png"

例: "InstallerIcon","D:\Documents\MATLAB\work\images\myIcon.png"

`InstallerLogo` — インストーラーイメージへのパス
文字ベクトル | string スカラー

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

既定のパスは次のとおりです。

"matlabroot\toolbox\compiler\packagingResources\default_logo.png"

例: "InstallerLogo","D:\Documents\MATLAB\work\images\myLogo.png"

`InstallerName` — インストーラーファイルの名前
`MyAppInstaller` (既定値) | 文字ベクトル | string スカラー

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

例: "InstallerName","MagicSquare_Installer"

`InstallerSplash` — スプラッシュスクリーンイメージへのパス
文字ベクトル | string スカラー

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

既定のパスは次のとおりです。

"matlabroot\toolbox\compiler\packagingResources\default_splash.png"

例: "InstallerSplash","D:\Documents\MATLAB\work\images\mySplash.png"

`OptionalDependencies` — 含めるオプションの依存関係
`"all"` (既定値) | `"none"`

R2025a 以降

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

"all" — すべてのオプションの依存関係をインストーラーに含めるオプション。グラフィカルサポートを含みます。このオプションは既定の動作です。
"none" — オプションの依存関係をインストーラーに含めないオプション。このオプションを使用して、生成されるインストーラーのサイズを最小化します。

例: "RuntimeDelivery","installer"

データ型: char | string

`OutputDir` — インストーラーの保存先フォルダーへのパス
文字ベクトル | string スカラー

インストーラーの保存先フォルダーへのパス。文字ベクトルまたは string スカラーとして指定します。

パスを指定しない場合、各オペレーティングシステムの既定のパスは次のとおりです。

オペレーティングシステム	既定のインストールディレクトリ
Windows	`.\appNameinstaller`
Linux	`./appNameinstaller`
macOS	`./appNameinstaller`

上記のディレクトリ内の . は、現在の作業ディレクトリを表します。

例: "OutputDir","D:\Documents\MATLAB\work\MagicSquare"

`PackageType` — インストーラーのファイルタイプ
`"auto"` (既定値) | `"zip"`

R2024a 以降

生成されるインストーラーのファイルタイプの選択肢。

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

例: "PackageType","zip"

データ型: char | string

`RuntimeDelivery` — MATLAB Runtime の引き渡しオプション
`"web"` (既定値) | `"installer"` | `"none"`

R2024a 以降

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

"web" — アプリケーションのインストール時にインストーラーが MathWorks^® の Web サイトから MATLAB Runtime をダウンロードするオプション。このオプションは既定の動作です。
"installer" — アプリケーションのインストール時に MathWorks Web サイトに接続せずにインストールできるように、インストーラー内に MATLAB Runtime を含めるオプション。エンドユーザーがインターネットにアクセスできない可能性があると考えられる場合は、このオプションを使用します。
"none" — アプリケーションのインストール時に MATLAB Runtime をインストールしないオプション。エンドユーザーが別の方法を使用して MATLAB Runtime をインストールすると考えられる場合は、このオプションを使用します。 (R2024a 以降)

メモ

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

例: "RuntimeDelivery","installer"

データ型: char | string

`Shortcut` — ショートカットへのパス
`""` (既定値) | 文字ベクトル | string スカラー

インストール時にインストーラーがショートカットを作成するファイルまたはフォルダーへのパス。文字ベクトルまたは string スカラーとして指定します。

例: "Shortcut",".\mymagic.exe"

データ型: char | string

`Summary` — アプリケーションの概要説明
`""` (既定値) | 文字ベクトル | string スカラー

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

例: "Summary","Generates a magic square."

データ型: char | string

`Version` — インストールされるアプリケーションのバージョン
`"1.0"` (既定値) | 文字ベクトル | string スカラー

インストールされるアプリケーションのバージョン番号。文字ベクトルまたは string スカラーとして指定します。

例: "Version","2.0"

データ型: char | string

`Verbose` — 出力の詳細を制御するためのフラグ
`"off"` (既定値) | on/off の logical 値

R2023b 以降

出力の詳細を制御するためのフラグ。"on" または "off"、もしくは数値または logical 1 (true) または 0 (false) として指定します。"on" の値は true と等価であり、"off" の値は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は、matlab.lang.OnOffSwitchState 型の on/off の logical 値として保存されます。

このプロパティを "on" に設定した場合、MATLAB コマンドウィンドウには、パッケージ化プロセス中のコンパイラ出力を示す進行状況情報が表示されます。
このプロパティを "off" に設定した場合、コマンドウィンドウには進行状況の情報は表示されません。これは既定の動作です。

例: "Verbose","on"

データ型: logical

出力引数

すべて折りたたむ

`opts` — InstallerOptions オブジェクト
`InstallerOptions` オブジェクト

インストーラーオプション。InstallerOptions オブジェクトとして返されます。

バージョン履歴

R2020a で導入

参考

compiler.package.installer | mcc

compiler.package.InstallerOptions

構文

説明

例

結果を使用したインストーラー オプション オブジェクトの作成

アプリケーション名を使用したインストーラー オプション オブジェクトの作成

入力引数

results — ビルド結果オブジェクト Results オブジェクト

appName — インストールされるアプリケーションの名前 文字ベクトル | string スカラー

名前と値の引数

AdditionalFiles — 追加ファイル 文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

AddRemoveProgramsIcon — [プログラムの追加と削除] アイコン 文字ベクトル | string スカラー | string 配列

ApplicationName — アプリケーション名 "" (既定値) | 文字ベクトル | string スカラー

AuthorCompany — 会社名 "" (既定値) | 文字ベクトル | string スカラー

AuthorEmail — 電子メール アドレス "" (既定値) | 文字ベクトル | string スカラー

AuthorName — 名前 "" (既定値) | 文字ベクトル | string スカラー

DefaultInstallationDir — 既定のインストール パス 文字ベクトル | string スカラー

Description — アプリケーションの詳細な説明 "" (既定値) | 文字ベクトル | string スカラー

InstallationNotes — メモ "" (既定値) | 文字ベクトル | string スカラー

InstallerIcon — アイコン イメージへのパス 文字ベクトル | string スカラー

InstallerLogo — インストーラー イメージへのパス 文字ベクトル | string スカラー

InstallerName — インストーラー ファイルの名前 MyAppInstaller (既定値) | 文字ベクトル | string スカラー

InstallerSplash — スプラッシュ スクリーン イメージへのパス 文字ベクトル | string スカラー

OptionalDependencies — 含めるオプションの依存関係 "all" (既定値) | "none"

OutputDir — インストーラーの保存先フォルダーへのパス 文字ベクトル | string スカラー

PackageType — インストーラーのファイル タイプ "auto" (既定値) | "zip"

RuntimeDelivery — MATLAB Runtime の引き渡しオプション "web" (既定値) | "installer" | "none"

Shortcut — ショートカットへのパス "" (既定値) | 文字ベクトル | string スカラー

Summary — アプリケーションの概要説明 "" (既定値) | 文字ベクトル | string スカラー

Version — インストールされるアプリケーションのバージョン "1.0" (既定値) | 文字ベクトル | string スカラー

Verbose — 出力の詳細を制御するためのフラグ "off" (既定値) | on/off の logical 値

出力引数

opts — InstallerOptions オブジェクト InstallerOptions オブジェクト

バージョン履歴

参考

結果を使用したインストーラーオプションオブジェクトの作成

アプリケーション名を使用したインストーラーオプションオブジェクトの作成

`results` — ビルド結果オブジェクト
`Results` オブジェクト

`appName` — インストールされるアプリケーションの名前
文字ベクトル | string スカラー

`AdditionalFiles` — 追加ファイル
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

`AddRemoveProgramsIcon` — [プログラムの追加と削除] アイコン
文字ベクトル | string スカラー | string 配列

`ApplicationName` — アプリケーション名
`""` (既定値) | 文字ベクトル | string スカラー

`AuthorCompany` — 会社名
`""` (既定値) | 文字ベクトル | string スカラー

`AuthorEmail` — 電子メールアドレス
`""` (既定値) | 文字ベクトル | string スカラー

`AuthorName` — 名前
`""` (既定値) | 文字ベクトル | string スカラー

`DefaultInstallationDir` — 既定のインストールパス
文字ベクトル | string スカラー

`Description` — アプリケーションの詳細な説明
`""` (既定値) | 文字ベクトル | string スカラー

`InstallationNotes` — メモ
`""` (既定値) | 文字ベクトル | string スカラー

`InstallerIcon` — アイコンイメージへのパス
文字ベクトル | string スカラー

`InstallerLogo` — インストーラーイメージへのパス
文字ベクトル | string スカラー

`InstallerName` — インストーラーファイルの名前
`MyAppInstaller` (既定値) | 文字ベクトル | string スカラー

`InstallerSplash` — スプラッシュスクリーンイメージへのパス
文字ベクトル | string スカラー

`OptionalDependencies` — 含めるオプションの依存関係
`"all"` (既定値) | `"none"`

`OutputDir` — インストーラーの保存先フォルダーへのパス
文字ベクトル | string スカラー

`PackageType` — インストーラーのファイルタイプ
`"auto"` (既定値) | `"zip"`

`RuntimeDelivery` — MATLAB Runtime の引き渡しオプション
`"web"` (既定値) | `"installer"` | `"none"`

`Shortcut` — ショートカットへのパス
`""` (既定値) | 文字ベクトル | string スカラー

`Summary` — アプリケーションの概要説明
`""` (既定値) | 文字ベクトル | string スカラー

`Version` — インストールされるアプリケーションのバージョン
`"1.0"` (既定値) | 文字ベクトル | string スカラー

`Verbose` — 出力の詳細を制御するためのフラグ
`"off"` (既定値) | on/off の logical 値

`opts` — InstallerOptions オブジェクト
`InstallerOptions` オブジェクト