compiler.package.installer
構文
説明
compiler.package.installer(
は、関数 results
)compiler.build
から生成された compiler.build.Results
オブジェクト results
を使用してインストーラーを作成します。
compiler.package.installer(
は、results
,Name,Value
)compiler.build.Results
オブジェクト results
と、名前と値の引数を 1 つ以上使って指定した追加オプションを用いてインストーラーを作成します。
compiler.package.installer(
は、files
,filePath
,'ApplicationName',appName
,Name,Value
)mcc
コマンドによって生成されたファイル用のインストーラーを作成します。インストールされるアプリケーションの名前は appName
で指定します。インストーラーは、オプションの名前と値の引数を使用してカスタマイズできます。
例
結果オブジェクトを使用したインストーラーの作成
関数 compiler.build.standaloneApplication
からの結果を使用して、スタンドアロン アプリケーションのインストーラーを作成します。
MATLAB® で、スタンドアロン アプリケーションとしてデプロイする MATLAB コードを見つけます。この例では、
にあるファイル matlabroot
\extern\examples\compilermagicsquare.m
を使用してコンパイルします。
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
compiler.build.standaloneApplication
コマンドを使用して、スタンドアロン アプリケーションをビルドします。
results = compiler.build.standaloneApplication(appFile);
関数 compiler.package.installer
を使用して、スタンドアロン アプリケーションのインストーラーを作成します。
compiler.package.installer(results);
magicsquareinstaller
という名前のフォルダー内に MyAppInstaller
という名前のインストーラーを生成します。アプリケーションの既定のインストール フォルダーは、ターゲット マシン上の %ProgramFiles%
環境変数の値です。
結果オブジェクトを使用したインストーラーのカスタマイズ
関数 compiler.build.standaloneApplication
からの結果を使用してスタンドアロン アプリケーションのインストーラーを作成し、名前と値の引数を使用してカスタマイズします。
にある matlabroot
\extern\examples\compilermagicsquare.m
ファイルへのパスを保存します。
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
compiler.build.standaloneApplication
コマンドを使用して、スタンドアロン アプリケーションをビルドします。
results = compiler.build.standaloneApplication(appFile);
関数 compiler.package.installer
で Results
オブジェクトを使用して、スタンドアロン アプリケーションのインストーラーを作成します。名前と値の引数を使用してインストーラー名を指定し、インストーラーに MATLAB Runtime を含めます。
compiler.package.installer(results,... 'InstallerName','MyMagicInstaller',... 'RuntimeDelivery','installer');
magicsquareinstaller
という名前のフォルダー内に MyMagicInstaller
という名前のインストーラーを生成します。結果オブジェクトとオプション オブジェクトを使用したインストーラーのカスタマイズ
関数 compiler.build.standaloneApplication
からの結果を使用して、Windows® システムでスタンドアロン アプリケーションのインストーラーを作成します。InstallerOptions
オブジェクトを使用してインストーラーをカスタマイズします。
にある matlabroot
\extern\examples\compilermagicsquare.m
ファイルへのパスを保存します。
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
compiler.build.standaloneApplication
コマンドを使用して、スタンドアロン アプリケーションをビルドします。
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\R2024b\toolbox\compiler\packagingResources\default_splash.png' InstallerIcon: 'C:\Program Files\MATLAB\R2024b\toolbox\compiler\packagingResources\default_icon_48.png' InstallerLogo: 'C:\Program Files\MATLAB\R2024b\toolbox\compiler\packagingResources\default_logo.png' PackageType: 'auto' AdditionalFiles: {} AddRemoveProgramsIcon: 'C:\Program Files\MATLAB\R2024b\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'
Results
オブジェクトと InstallerOptions
オブジェクトを関数 compiler.package.installer
への入力として使用し、スタンドアロン アプリケーションのインストーラーを作成します。
compiler.package.installer(results,'Options',opts);
MagicSquare_Generatorinstaller
という名前のフォルダー内に MagicSquare_Installer
という名前のインストーラーを生成します。ファイルを使用したインストーラーの作成
Windows システムのスタンドアロン アプリケーションのインストーラーを作成します。
魔方陣を生成する MATLAB 関数を記述します。この関数を mymagic.m
という名前のファイルに保存します。
function out = mymagic(in)
out = magic(in)
mcc
コマンドを使用して、スタンドアロン アプリケーションをビルドします。
mcc -m mymagic.m
mymagic.exe mccExcludedFiles.log readme.txt requiredMCRProducts.txt
関数 compiler.package.installer
を使用して、スタンドアロン アプリケーションのインストーラーを作成します。
compiler.package.installer('mymagic.exe',... 'D:\Documents\MATLAB\work\MagicSquare\requiredMCRProducts.txt',... 'ApplicationName','MagicSquare_Generator')
MagicSquare_Generatorinstaller
という名前のフォルダー内に MyAppInstaller.exe
という名前のインストーラーを生成します。ファイルを使用したインストーラーのカスタマイズ
名前と値の引数を使用して、スタンドアロン アプリケーションのインストーラーをカスタマイズします。
compiler.build.standaloneApplication
コマンドを使用して、スタンドアロン アプリケーションをビルドします。
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m'); buildResults = compiler.build.standaloneApplication(appFile);
生成された requiredMCRProducts.txt
ファイルへのパスを保存します。
runtimeProducts = fullfile(buildResults.Options.OutputDir,'requiredMCRProducts.txt')
スタンドアロン アプリケーションのビルド結果からのファイルのリストを保存します。
fileList = buildResults.Files
オプションで fileList
を変更して、さらにファイルをインストーラーに追加できます。追加ファイルはアプリケーションの実行可能ファイルと共に、インストール ディレクトリにインストールされます。
fileList = [fileList; {'UsageNotes.txt'}];
関数 compiler.package.installer
を使用して、スタンドアロン アプリケーションのインストーラーを作成します。
compiler.package.installer(fileList, runtimeProducts,... 'ApplicationName','CustomMagicSquare',... 'InstallerName','Installer_With_Addl_Files',... 'Summary','See UsageNotes.txt for info.')
ファイルとインストーラー オプション オブジェクトを使用したインストーラーのカスタマイズ
InstallerOptions
オブジェクトを使用して、Windows システムのスタンドアロン アプリケーションのインストーラーをカスタマイズします。
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\R2024b\toolbox\compiler\packagingResources\default_splash.ico' InstallerIcon: 'C:\Program Files\MATLAB\R2024b\toolbox\compiler\packagingResources\default_icon_48.ico' InstallerLogo: 'C:\Program Files\MATLAB\R2024b\toolbox\compiler\packagingResources\default_logo.png' PackageType: 'auto' 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'
InstallerOptions
オブジェクトを入力として関数に渡します。
compiler.package.installer('mymagic.exe','requiredMCRProducts.txt','Options',opts)
入力引数
results
— ビルド結果オブジェクト
Results
オブジェクト
ビルド結果。compiler.build.Results
オブジェクトとして指定します。関数 compiler.build
からの出力を保存することで、Results
オブジェクトを作成します。
files
— インストール用のファイルとフォルダーのリスト
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列
インストール用のファイルとフォルダーのリスト。文字ベクトル、string スカラー、文字ベクトルの cell 配列、または string 配列として指定します。これらのファイルは、通常、mcc
コマンドまたは関数 compiler.build
によって生成され、インストールされるアプリケーションの実行に必要な追加のファイルおよびフォルダーも含めることができます。追加ファイルはアプリケーションの実行可能ファイルと共に、インストール ディレクトリにインストールされます。
特定のリリースで生成されたファイルは、同じリリースの関数
compiler.package.installer
を使用してパッケージ化できます。あるオペレーティング システム上のタイプ
.ctf
のファイルは、別のオペレーティング システムで関数compiler.package.installer
を使用してパッケージ化できます。ただし、ビルド コマンドと関数compiler.package.installer
のリリースが同じである場合に限られます。
例: {'mymagic.exe','UsageNotes.txt'}
データ型: char
| string
filePath
— requiredMCRProducts.txt
ファイルへのパス
文字ベクトル | string スカラー
MATLAB Compiler™ によって生成された requiredMCRProducts.txt
ファイルへのパス。
例: 'D:\Documents\MATLAB\work\MagicSquare\requiredMCRProducts.txt'
データ型: char
| string
appName
— インストールされるアプリケーションの名前
文字ベクトル | string スカラー
インストールされるアプリケーションの名前。文字ベクトルまたは string スカラーとして指定します。
例: 'MagicSquare_Generator'
データ型: char
| string
opts
— InstallerOptions オブジェクト
InstallerOptions
オブジェクト
インストーラー オプション。InstallerOptions
オブジェクトとして指定します。
名前と値の引数
オプションのペアの引数を Name1=Value1,...,NameN=ValueN
として指定します。ここで、Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: 'Version','9.5'
は、インストールされているアプリケーションのバージョンを指定します。
AdditionalFiles
— 追加ファイル
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列
アプリケーションとともにインストールする追加のファイルとフォルダー。文字ベクトル、string スカラー、string 配列、または文字ベクトルの cell 配列として指定します。パスは現在の作業ディレクトリを基準とした相対パス、または絶対パスにできます。
例: 'AdditionalFiles',["myimage.png","data.mat"]
データ型: char
| string
| cell
AddRemoveProgramsIcon
— [プログラムの追加と削除] アイコン
文字ベクトル | string スカラー | string 配列
[プログラムの追加と削除] アイコン。文字ベクトルまたは 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\ |
Linux® | /usr/ |
macOS | /Applications/ |
例: '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'
OutputDir
— インストーラーの保存先フォルダーへのパス
文字ベクトル | string スカラー
インストーラーの保存先フォルダーへのパス。文字ベクトルまたは string スカラーとして指定します。
パスを指定しない場合、各オペレーティング システムの既定のパスは次のとおりです。
オペレーティング システム | 既定のインストール ディレクトリ |
---|---|
Windows | .\ |
Linux | ./ |
macOS | ./ |
上記のディレクトリ内の .
は、現在の作業ディレクトリを表します。
例: 'OutputDir','D:\Documents\MATLAB\work\MagicSquare'
PackageType
— インストーラーのファイル タイプ
'auto'
(既定値) | 'zip'
生成されるインストーラーのファイル タイプの選択肢。
'auto'
— インストーラーの作成時に適切なパッケージ タイプをインストーラーで自動的に選択するオプション。インストーラーのサイズが 2 GB 以上の場合、インストーラーは ZIP ファイルとしてパッケージ化されます。これは既定のオプションです。'zip'
— 新しいインストーラーの作成時に ZIP ファイルを出力として生成するオプション。このオプションは Windows でのみサポートされています。
例: 'PackageType','zip'
データ型: char
| string
RuntimeDelivery
— MATLAB Runtime の引き渡しオプション
'web'
(既定値) | 'installer'
| 'none'
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 値
出力の詳細を制御するためのフラグ。'on'
または 'off'
、もしくは数値または logical 1
(true
) または 0
(false
) として指定します。'on'
の値は true
と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
このプロパティを
'on'
に設定した場合、MATLAB コマンド ウィンドウには、パッケージ化プロセス中のコンパイラ出力を示す進行状況情報が表示されます。このプロパティを
'off'
に設定した場合、コマンド ウィンドウには進行状況の情報は表示されません。これは既定の動作です。
例: 'Verbose','on'
データ型: logical
ヒント
この関数で作成されたインストーラーは、MATLAB Compiler により生成されたアーティファクトと、オプションで完全な MATLAB Runtime をインストールします。1 つ以上の特定の MATLAB Compiler アプリケーションを実行できる最小限の MATLAB Runtime インストーラーを作成するには、
compiler.runtime.customInstaller
を参照してください。
バージョン履歴
R2020a で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- 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)