compiler.build.Results

コンパイラビルド結果オブジェクト

説明

compiler.build.Results オブジェクトには、compiler.build 関数のビルドタイプ、生成ファイル、サポートパッケージ、ビルドオプション、依存関係に関する情報が含まれています。

Results のプロパティはすべて読み取り専用です。これらのプロパティのクエリにはドット表記を使用できます。

MATLAB^® Compiler™ では、スタンドアロンアプリケーション、Excel^® アドイン、または Web アプリアーカイブを作成できます。

MATLAB Compiler SDK™ では、C/C++ 共有ライブラリ、.NET アセンブリ、COM コンポーネント、Java^® パッケージ、Python^® パッケージ、MATLAB Production Server™ のデプロイ可能アーカイブ、または MATLAB Production Server 用 Excel アドインを作成できます。

作成

compiler.build.Results オブジェクトを作成する方法はいくつかあります。

compiler.build.standaloneApplication を使用してスタンドアロンアプリケーションを作成する (例)。
compiler.build.standaloneWindowsApplication を使用してスタンドアロンの Windows^® アプリケーションを作成する (例)。
compiler.build.webAppArchive を使用して Web アプリアーカイブを作成する (例)。
compiler.build.excelAddIn を使用して Excel アドインを作成する (例)。

MATLAB Compiler SDK のライセンスがある場合、次のオブジェクトも作成できます。

compiler.build.cSharedLibrary を使用して C 共有ライブラリを作成する (例)。
compiler.build.cppSharedLibrary を使用して C++ 共有ライブラリを作成する (例)。
compiler.build.dotNETAssembly を使用して .NET アセンブリを作成する (例)。
compiler.build.javaPackage を使用して Java パッケージを作成する (例)。
compiler.build.pythonPackage を使用して Python パッケージを作成する (例)。
compiler.build.productionServerArchive を使用して Production Server アーカイブを作成する (例)。
compiler.build.excelClientForProductionServer を使用して MATLAB Production Server 用の Excel アドインを作成する (例)。
compiler.build.comComponent を使用して COM コンポーネントを作成する (例)。

プロパティ

すべて展開する

`BuildType` — ビルドタイプ
`'standaloneApplication'` | `'standaloneWindowsApplication'` | `'webAppArchive'` | `'productionServerArchive'` | `'excelAddIn'` | `'comComponent'` | `'cSharedLibrary'` | `'cppSharedLibrary'` | `'dotNETAssembly'` | `'javaPackage'` | `'pythonPackage'` | `'excelClientForProductionServer'`

このプロパティは読み取り専用です。

結果の生成に使用する関数 compiler.build のビルドタイプ。文字ベクトルとして指定します。

`compiler.build` 関数	ビルドタイプ
`compiler.build.standaloneApplication`	`'standaloneApplication'`
`compiler.build.standaloneWindowsApplication`	`'standaloneWindowsApplication'`
`compiler.build.webAppArchive`	`'webAppArchive'`
`compiler.build.productionServerArchive`	`'productionServerArchive'`
`compiler.build.excelAddIn`	`'excelAddIn'`
`compiler.build.comComponent`	`'comComponent'`
`compiler.build.cSharedLibrary`	`'cSharedLibrary'`
`compiler.build.cppSharedLibrary`	`'cppSharedLibrary'`
`compiler.build.dotNETAssembly`	`'dotNETAssembly'`
`compiler.build.javaPackage`	`'javaPackage'`
`compiler.build.pythonPackage`	`'pythonPackage'`
`compiler.build.excelClientForProductionServer`	`'excelClientForProductionServer'`

データ型: char

`Files` — コンパイル済みファイルへのパス
文字ベクトルの cell 配列

このプロパティは読み取り専用です。

結果の生成に使用する関数 compiler.build のコンパイル済みファイルへのパス。文字ベクトルの cell 配列として指定します。

ビルドタイプ	ファイル
`'standaloneApplication'`	2 行 1 列の cell 配列 {'path\to\ExecutableName.exe'} {'path\to\readme.txt'}
`'standaloneWindowsApplication'`	3 行 1 列の cell 配列 {'path\to\ExecutableName.exe'} {'path\to\splash.png'} {'path\to\readme.txt'}
`'webAppArchive'`	1 行 1 列の cell 配列 {'path\to\ArchiveName.ctf'}
`'productionServerArchive'`	1 行 1 列の cell 配列 {'path\to\ArchiveName.ctf'}
`'excelAddIn'`	2 行 1 列または 4 行 1 列の cell 配列 {'path\to\AddInName_AddInVersion.dll'} {'path\to\AddInName.bas'} {'path\to\AddInName.xla'} {'path\to\GettingStarted.html'} メモファイル `AddInName.bas` および `AddInName.xla` は、`'GenerateVisualBasicFile'` オプションを有効にした場合にのみ含められます。
`'comComponent'`	2 行 1 列の cell 配列 {'path\to\ComponentName_ComponentVersion.dll'} {'path\to\GettingStarted.html'}
`'cSharedLibrary'`	4 行 1 列の cell 配列 {'path\to\LibraryName.h'} {'path\to\LibraryName.dll'} {'path\to\LibraryName.lib'} {'path\to\GettingStarted.html'}
`'cppSharedLibrary'`	2 行 1 列または 4 行 1 列の cell 配列 `matlab-data` インターフェイスを使用: {'path\to\v2\'} {'path\to\GettingStarted.html'} `mwArray` インターフェイスを使用: {'path\to\LibraryName.h'} {'path\to\LibraryName.dll'} {'path\to\LibraryName.lib'} {'path\to\GettingStarted.html'}
`'dotNETAssembly'`	4 行 1 列の cell 配列 {'path\to\AssemblyName.dll'} {'path\to\AssemblyNameNative.dll'} {'path\to\AssemblyName_overview.html'} {'path\to\GettingStarted.html'}
`'javaPackage'`	3 行 1 列の cell 配列 {'path\to\PackageName.jar'} {'path\to\doc\'} {'path\to\GettingStarted.html'}
`'pythonPackage'`	3 行 1 列の cell 配列 {'path\to\example\'} {'path\to\setup.py'} {'path\to\GettingStarted.html'}
`'excelClientForProductionServer'`	1 行 1 列または 3 行 1 列の cell 配列 {'path\to\AddInName.dll'} {'path\to\AddInName.bas'} {'path\to\AddInName.xla'} メモファイル `AddInName.bas` および `AddInName.xla` は、`'GenerateVisualBasicFile'` オプションを有効にした場合にのみ含められます。

例: {'D:\Documents\MATLAB\work\MagicSquarewebAppproductionServerArchive\MagicSquare.ctf'}

データ型: cell

`IncludedSupportPackages` — サポートパッケージ
文字ベクトルの cell 配列

このプロパティは読み取り専用です。

生成されたコンポーネントに含められるサポートパッケージ。文字ベクトルの cell 配列として指定します。

`Options` — ビルドオプション
`StandaloneApplicationOptions` | `WebAppArchiveOptions` | `ProductionServerArchiveOptions` | `ExcelAddInOptions` | `COMComponentOptions` | `CSharedLibraryOptions` | `CppSharedLibraryOptions` | `DotNETAssemblyOptions` | `JavaPackageOptions` | `PythonPackageOptions` | `ExcelClientForProductionServerOptions`

このプロパティは読み取り専用です。

結果の生成に使用される関数 compiler.build のビルドオプション。対応するビルドタイプのオプションオブジェクトとして指定します。

ビルドタイプ	オプション
`'standaloneApplication'`	`StandaloneApplicationOptions`
`'standaloneWindowsApplication'`	`StandaloneApplicationOptions`
`'webAppArchive'`	`WebAppArchiveOptions`
`'productionServerArchive'`	`ProductionServerArchiveOptions`
`'excelAddIn'`	`ExcelAddInOptions`
`'comComponent'`	`COMComponentOptions`
`'cSharedLibrary'`	`CSharedLibraryOptions`
`'cppSharedLibrary'`	`CppSharedLibraryOptions`
`'dotNETAssembly'`	`DotNETAssemblyOptions`
`'javaPackage'`	`JavaPackageOptions`
`'pythonPackage'`	`PythonPackageOptions`
`'excelClientForProductionServer'`	`ExcelClientForProductionServerOptions`

`RuntimeDependencies` — オプションおよび必須の依存関係
2 つのテーブルを含むオブジェクト

このプロパティは読み取り専用です。

生成されたコンポーネントの Runtime 依存関係。2 つのテーブル (Required と Optional) を含む Dependencies オブジェクトとして指定します。各テーブルには依存関係のコレクションが含まれます。

例

すべて折りたたむ

スタンドアロンアプリケーションからのビルド情報の取得

スタンドアロンアプリケーションを作成し、ビルドタイプ、生成ファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用してコンパイルします。

results = compiler.build.standaloneApplication('magicsquare.m')

results = 

              BuildType: 'standaloneApplication'
                  Files: {2×1 cell}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.StandaloneApplicationOptions]   
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、magicsquare スタンドアロン実行可能ファイルと readme.txt ファイルへのパスが格納されます。

スタンドアロンの Windows アプリケーションからのビルド情報の取得

スタンドアロンの Windows アプリケーションを Windows システムで作成し、ビルドタイプ、生成ファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル Mortgage.mlapp を使用してコンパイルします。

results = compiler.build.standaloneWindowsApplication('Mortgage.mlapp')

results = 

  Results with properties:

              BuildType: 'standaloneWindowsApplication'
                  Files: {3×1 cell}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.StandaloneApplicationOptions] 
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、以下のファイルへのパスが格納されます。

Mortgage.exe
splash.png
readme.txt

Web アプリアーカイブからのビルド情報の取得

Web アプリアーカイブを作成し、ビルドタイプ、アーカイブファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル Mortgage.mlapp を使用してコンパイルします。

results = compiler.build.webAppArchive('Mortgage.mlapp')

results = 

  Results with properties:

              BuildType: 'webAppArchive'
                  Files: {'D:\Documents\MATLAB\work\MortgagewebAppArchive\Mortgage.ctf'}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.WebAppArchiveOptions]
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、デプロイ可能なアーカイブファイル Mortgage.ctf へのパスが格納されます。

Production Server アーカイブからのビルド情報の取得

Production Server アーカイブを作成し、ビルドタイプ、アーカイブファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用してコンパイルします。

results = compiler.build.productionServerArchive('magicsquare.m')

results = 

  Results with properties:

                  BuildType: 'productionServerArchive'
                      Files: {'D:\Documents\MATLAB\work\magicsquareproductionServerArchive\magicsquare.ctf'}
    IncludedSupportPackages: {}
                    Options: [1×1 compiler.build.ProductionServerArchiveOptions]
        RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、デプロイ可能なアーカイブファイル magicsquare.ctf へのパスが格納されます。

Excel アドインからのビルド情報の取得

Excel アドインを作成し、ビルドタイプ、生成ファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用してコンパイルします。

results = compiler.build.excelAddIn('magicsquare.m')

results = 

  Results with properties:

              BuildType: 'excelAddIn'
                  Files: {2×1 cell}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.ExcelAddInOptions]
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、以下のコンパイル済みファイルへのパスが格納されます。

magicsquare_1_0.dll
GettingStarted.html

メモ

ファイル magicsquare.bas および magicsquare.xla は、ビルドコマンドで 'GenerateVisualBasicFile' オプションを有効にした場合にのみ Files に含められます。

COM コンポーネントからのビルド情報の取得

COM コンポーネントを Windows システムで作成し、ビルドタイプ、生成ファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用してコンパイルします。

results = compiler.build.comComponent('magicsquare.m')

results = 

  Results with properties:

              BuildType: 'comComponent'
                  Files: {2×1 cell}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.COMComponentOptions]
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、以下のコンパイル済みファイルへのパスが格納されます。

magicsquare_1_0.dll
GettingStarted.html

C ライブラリからのビルド情報の取得

C ライブラリを作成し、ビルドタイプ、コンパイル済みファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用してコンパイルします。

results = compiler.build.cSharedLibrary('magicsquare.m')

results = 

  Results with properties:

              BuildType: 'cSharedLibrary'
                  Files: {4×1 cell}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.CSharedLibraryOptions]
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、以下のファイルへのパスが格納されます。

magicsquare.dll
magicsquare.lib
magicsquare.h
GettingStarted.html

C++ ライブラリからのビルド情報の取得

C++ ライブラリを作成し、ビルドタイプ、コンパイル済みファイル、サポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用してコンパイルします。

results = compiler.build.cppSharedLibrary('magicsquare.m')

results = 

  Results with properties:

              BuildType: 'cppSharedLibrary'
                  Files: {2×1 cell}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.CppSharedLibraryOptions]
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、v2 フォルダーおよび GettingStarted.html へのパスが格納されます。

.NET アセンブリからのビルド情報の取得

.NET アセンブリを Windows システムで作成し、ビルドタイプ、生成ファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用してコンパイルします。

results = compiler.build.dotNETAssembly('magicsquare.m')

results = 

  Results with properties:

              BuildType: 'dotNETAssembly'
                  Files: {4×1 cell}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.DotNETAssemblyOptions]
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、以下のコンパイル済みファイルへのパスが格納されます。

magicsquare.dll
magicsquareNative.dll
magicsquare_overview.dll
GettingStarted.html

Java パッケージからのビルド情報の取得

Java パッケージを作成し、ビルドタイプ、生成ファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用してコンパイルします。

results = compiler.build.javaPackage('magicsquare.m')

results = 

  Results with properties:

              BuildType: 'javaPackage'
                  Files: {3×1 cell}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.JavaPackageOptions]
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、以下へのパスが格納されます。

doc フォルダー
magicsquare.jar
GettingStarted.html

Python パッケージからのビルド情報の取得

Python パッケージを作成し、ビルドタイプ、生成ファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用してコンパイルします。

results = compiler.build.pythonPackage('magicsquare.m');

results = 

  Results with properties:

            BuildType: 'pythonPackage'
                Files: {3×1 cell}
IncludedSupportPackages: {}
              Options: [1×1 compiler.build.PythonPackageOptions]
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、以下へのパスが格納されます。

example フォルダー
setup.py
GettingStarted.html

MATLAB Production Server 用の Excel アドインからのビルド情報の取得

MATLAB Production Server 用の Excel アドインを作成し、ビルドタイプ、生成ファイル、含まれるサポートパッケージ、およびビルドオプションに関する情報を compiler.build.Results オブジェクトに保存します。

ファイル magicsquare.m を使用して MATLAB Production Server アーカイブをビルドします。出力を compiler.build.Results オブジェクト serverBuildResults として保存します。

serverBuildResults = compiler.build.productionServerArchive('magicsquare.m');

serverBuildResults オブジェクトを使用して、Excel アドインをビルドします。

results = compiler.build.excelClientForProductionServer(serverBuildResults)

results = 

  Results with properties:

              BuildType: 'excelClientForProductionServer'
                  Files: {1×1 cell}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.ExcelClientForProductionServerOptions]
    RuntimeDependencies: [1×1 compiler.runtime.Dependencies]

Files プロパティには、以下のコンパイル済みファイルへのパスが格納されます。

magicsquare.dll
magicsquare.bas
magicsquare.xla

メモ

ファイル magicsquare.bas および magicsquare.xla は、compiler.build.excelClientForProductionServer コマンドで 'GenerateVisualBasicFile' オプションを有効にした場合にのみ Files に含められます。

バージョン履歴

R2020b で導入

参考

compiler.build.Results

説明

作成

プロパティ

BuildType — ビルド タイプ 'standaloneApplication' | 'standaloneWindowsApplication' | 'webAppArchive' | 'productionServerArchive' | 'excelAddIn' | 'comComponent' | 'cSharedLibrary' | 'cppSharedLibrary' | 'dotNETAssembly' | 'javaPackage' | 'pythonPackage' | 'excelClientForProductionServer'

Files — コンパイル済みファイルへのパス 文字ベクトルの cell 配列

IncludedSupportPackages — サポート パッケージ 文字ベクトルの cell 配列

RuntimeDependencies — オプションおよび必須の依存関係 2 つのテーブルを含むオブジェクト

例

スタンドアロン アプリケーションからのビルド情報の取得

スタンドアロンの Windows アプリケーションからのビルド情報の取得

Web アプリ アーカイブからのビルド情報の取得

Production Server アーカイブからのビルド情報の取得

Excel アドインからのビルド情報の取得

COM コンポーネントからのビルド情報の取得

C ライブラリからのビルド情報の取得

C++ ライブラリからのビルド情報の取得

.NET アセンブリからのビルド情報の取得

Java パッケージからのビルド情報の取得

Python パッケージからのビルド情報の取得

MATLAB Production Server 用の Excel アドインからのビルド情報の取得

バージョン履歴

参考

`Files` — コンパイル済みファイルへのパス
文字ベクトルの cell 配列

`IncludedSupportPackages` — サポートパッケージ
文字ベクトルの cell 配列

`RuntimeDependencies` — オプションおよび必須の依存関係
2 つのテーブルを含むオブジェクト

スタンドアロンアプリケーションからのビルド情報の取得

Web アプリアーカイブからのビルド情報の取得