compiler.package.InstallerOptions
MATLAB Compiler パッケージ インストーラーの作成オプション
構文
説明
は、関数 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
,Name,Value
)appName
で指定されたアプリケーション名と、名前と値の引数で指定された追加のカスタマイズを使って、InstallerOptions
オブジェクト opts
を作成します。InstallerOptions
オブジェクトは、関数 compiler.package.installer
に入力として渡されます。
例
関数 compiler.build.standaloneApplication
からの結果と、名前と値の引数として指定された追加オプションを使用して、InstallerOptions
オブジェクトを作成します。
この例では、
にあるファイル matlabroot
\extern\examples\compilermagicsquare.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'
入力引数
ビルド結果。compiler.build.Results
オブジェクトとして指定します。関数 compiler.build
からの出力を保存することで、Results
オブジェクトを作成します。
インストールされるアプリケーションの名前。文字ベクトルまたは string スカラーとして指定します。
例: 'MagicSquare_Generator'
データ型: char
| string
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで、Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name
を引用符で囲みます。
例: "Version","9.5"
は、インストールされているアプリケーションのバージョンを指定します。
R2023a 以降
アプリケーションとともにインストールする追加のファイルとフォルダー。文字ベクトル、string スカラー、string 配列、または文字ベクトルの cell 配列として指定します。パスは現在の作業ディレクトリを基準とした相対パス、または絶対パスにできます。
例: "AdditionalFiles",["myimage.png","data.mat"]
データ型: char
| string
| cell
R2023a 以降
[プログラムの追加と削除] アイコン。文字ベクトルまたは string スカラーとして指定します。イメージは、設定内の Windows® アプリケーションのリストでアイコンとして使用されます。パスは現在の作業ディレクトリを基準とした相対パス、または絶対パスにできます。
既定のパスは次のとおりです。
"matlabroot
\toolbox\compiler\packagingResources\default_icon_48.png"
例: "AddRemoveProgramsIcon","win_icon.png"
データ型: char
| string
インストールされるアプリケーションの名前。文字ベクトルまたは string スカラーとして指定します。
例: "ApplicationName","MagicSquare_Generator"
データ型: char
| string
アプリケーションを作成した会社名。文字ベクトルまたは string スカラーとして指定します。
例: "AuthorCompany","Boston Common"
データ型: char
| string
アプリケーション作成者の電子メール アドレス。文字ベクトルまたは string スカラーとして指定します。
例: "AuthorEmail","frog@example.com"
データ型: char
| string
アプリケーション作成者の名前。文字ベクトルまたは string スカラーとして指定します。
例: "AuthorName","Frog"
データ型: char
| string
インストーラーがアプリケーションをインストールする既定のディレクトリ。文字ベクトルまたは string スカラーとして指定します。
パスを指定しない場合、各オペレーティング システムの既定のパスは次のとおりです。
オペレーティング システム | 既定のインストール ディレクトリ |
---|---|
Windows | C:\Program Files\ |
Linux® | /usr/ |
macOS | /Applications/ |
例: "DefaultInstallationDir","C:\Users\MW_Programs\MagicSquare_Generator"
データ型: char
| 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
アプリケーションの使用に関する追加要件についてのメモ。文字ベクトルまたは string スカラーとして指定します。
例: "InstallationNotes","This is a Linux installer."
データ型: char
| string
インストールされるアプリケーションのアイコンとして使用するイメージ ファイルへのパス。文字ベクトルまたは string スカラーとして指定します。
既定のパスは次のとおりです。
"matlabroot
\toolbox\compiler\packagingResources\default_icon_48.png"
例: "InstallerIcon","D:\Documents\MATLAB\work\images\myIcon.png"
インストーラーのロゴとして使用するイメージ ファイルへのパス。文字ベクトルまたは string スカラーとして指定します。ロゴのサイズは 112 x 290 ピクセルに変更されます。
既定のパスは次のとおりです。
"matlabroot
\toolbox\compiler\packagingResources\default_logo.png"
例: "InstallerLogo","D:\Documents\MATLAB\work\images\myLogo.png"
インストーラー ファイルの名前。文字ベクトルまたは string スカラーとして指定します。拡張子は、関数が実行されるオペレーティング システムによって決まります。
例: "InstallerName","MagicSquare_Installer"
インストーラーのスプラッシュ スクリーンとして使用するイメージ ファイルへのパス。文字ベクトルまたは string スカラーとして指定します。スプラッシュ スクリーンのアイコンのサイズは 400 x 400 ピクセルに変更されます。
既定のパスは次のとおりです。
"matlabroot
\toolbox\compiler\packagingResources\default_splash.png"
例: "InstallerSplash","D:\Documents\MATLAB\work\images\mySplash.png"
R2025a 以降
インストーラーに含めるオプションの MATLAB® Runtime 依存関係。次のいずれかとして指定します。
"all"
— すべてのオプションの依存関係をインストーラーに含めるオプション。グラフィカル サポートを含みます。このオプションは既定の動作です。"none"
— オプションの依存関係をインストーラーに含めないオプション。このオプションを使用して、生成されるインストーラーのサイズを最小化します。
例: "RuntimeDelivery","installer"
データ型: char
| string
インストーラーの保存先フォルダーへのパス。文字ベクトルまたは string スカラーとして指定します。
パスを指定しない場合、各オペレーティング システムの既定のパスは次のとおりです。
オペレーティング システム | 既定のインストール ディレクトリ |
---|---|
Windows | .\ |
Linux | ./ |
macOS | ./ |
上記のディレクトリ内の .
は、現在の作業ディレクトリを表します。
例: "OutputDir","D:\Documents\MATLAB\work\MagicSquare"
R2024a 以降
生成されるインストーラーのファイル タイプの選択肢。
"auto"
— インストーラーの作成時に適切なパッケージ タイプをインストーラーで自動的に選択するオプション。インストーラーのサイズが 2 GB 以上の場合、インストーラーは ZIP ファイルとしてパッケージ化されます。これは既定のオプションです。"zip"
— 新しいインストーラーの作成時に ZIP ファイルを出力として生成するオプション。このオプションは Windows でのみサポートされています。
例: "PackageType","zip"
データ型: char
| string
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
インストール時にインストーラーがショートカットを作成するファイルまたはフォルダーへのパス。文字ベクトルまたは string スカラーとして指定します。
例: "Shortcut",".\mymagic.exe"
データ型: char
| string
アプリケーションの概要説明。文字ベクトルまたは string スカラーとして指定します。
例: "Summary","Generates a magic square."
データ型: char
| string
インストールされるアプリケーションのバージョン番号。文字ベクトルまたは string スカラーとして指定します。
例: "Version","2.0"
データ型: char
| string
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
出力引数
インストーラー オプション。InstallerOptions
オブジェクトとして返されます。
バージョン履歴
R2020a で導入
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Web サイトの選択
Web サイトを選択すると、翻訳されたコンテンツにアクセスし、地域のイベントやサービスを確認できます。現在の位置情報に基づき、次のサイトの選択を推奨します:
また、以下のリストから Web サイトを選択することもできます。
最適なサイトパフォーマンスの取得方法
中国のサイト (中国語または英語) を選択することで、最適なサイトパフォーマンスが得られます。その他の国の MathWorks のサイトは、お客様の地域からのアクセスが最適化されていません。
南北アメリカ
- América Latina (Español)
- Canada (English)
- United States (English)
ヨーロッパ
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)