Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

compiler.build.webAppArchive

MATLAB Web App Server にデプロイするアーカイブの作成

説明

compiler.build.webAppArchive(AppFile) は、AppFile で指定された MATLAB® アプリを使用して Web アプリ アーカイブを作成します。

compiler.build.webAppArchive(AppFile,Name,Value) は、名前と値の引数を 1 つ以上使用してオプションが指定された Web アプリ アーカイブを作成します。オプションには、アーカイブ名、含める追加ファイル、出力ディレクトリなどがあります。

compiler.build.webAppArchive(opts) は、compiler.build.WebAppArchiveOptions オブジェクト opts を使用してオプションが指定された Web アプリ アーカイブを作成します。名前と値の引数を使用して他のオプションを指定することはできません。

results = compiler.build.webAppArchive(___) は、前述の構文にある引数の任意の組み合わせを使用して、ビルド情報を compiler.build.Results オブジェクトとして返します。ビルド情報は、ビルド タイプ、コンパイル済みアーカイブへのパス、およびビルド オプションで構成されます。

すべて折りたたむ

Mortgage.mlapp という名前の MATLAB アプリを使用して Web アプリ アーカイブを作成します。

この例では、matlabroot\examples\matlab\main にあるファイル Mortgage.mlapp を使用してコンパイルします。

appFile = fullfile(matlabroot,'examples','matlab','main','Mortgage.mlapp');

compiler.build.webAppArchive を使用して Web アプリ アーカイブをビルドします。

compiler.build.webAppArchive(appFile);

ビルド関数により、現在の作業ディレクトリの MortgagewebAppArchive という名前のフォルダー内に以下のファイルが生成されます。

  • includedSupportPackages.txt — アーカイブに含まれている、すべてのサポートされるファイルをリストしたテキスト ファイル。

  • Mortgage.ctf — デプロイ可能なアーカイブが含まれるコンポーネント テクノロジー ファイル。

  • mccExcludedFiles.log — Web アプリに含まれていないすべてのツールボックス関数のリストが含まれるログ ファイル。サポートされていない関数の詳細については、MATLAB Compiler の制限を参照してください。

  • requiredMCRProducts.txtMATLAB Runtime が Web アプリを実行するために必要な製品の製品 ID が含まれるテキスト ファイル。

  • unresolvedSymbols.txt — 未解決のシンボルに関する情報が含まれるテキスト ファイル。

Web アプリのデプロイに関する詳細については、Web アプリのデプロイを参照してください。

Web アプリ アーカイブを作成し、名前と値の引数を使用してカスタマイズします。

この例では、Mortgage.mlapp アプリを使用してコンパイルします。名前と値の引数を使用してアーカイブ名と出力ディレクトリを指定し、ビルド プロセス中に進行状況に関する情報を表示します。

appFile = fullfile(matlabroot,'examples','matlab','main','Mortgage.mlapp');
compiler.build.webAppArchive(appFile, ...
    'ArchiveName','MyWebApp', ...
    'OutputDir','D:\Documents\MATLAB\work\WebApps', ...
    'Verbose','on')

関数により、現在の作業ディレクトリの WebApps という名前のフォルダー内に以下のファイルが生成されます。

  • includedSupportPackages.txt

  • Mortgage.ctf

  • mccExcludedFiles.log

  • requiredMCRProducts.txt

  • unresolvedSymbols.txt

compiler.build.WebAppArchiveOptions オブジェクトを使用して、複数の Web アプリ アーカイブを作成します。

ファイル Mortgage.mlapp を使用して WebAppArchiveOptions オブジェクトを作成します。名前と値の引数を使用して共通の出力ディレクトリを指定し、データ ファイルの自動検出を無効にします。

appFile = fullfile(matlabroot,'examples','matlab','main','Mortgage.mlapp');
opts = compiler.build.WebAppArchiveOptions(appFile, ...
    'OutputDir','D:\Documents\MATLAB\work\WebAppBatch', ...
    'AutoDetectDataFiles','off')
opts = 

  WebAppArchiveOptions with properties:

                AppFile: 'D:\Documents\MATLAB\work\Mortgage.mlapp'
            ArchiveName: 'Mortgage'
        AdditionalFiles: {}
    AutoDetectDataFiles: off
        SupportPackages: {'autodetect'}
                Verbose: off
              OutputDir: 'D:\Documents\MATLAB\work\WebAppBatch'

WebAppArchiveOptions オブジェクトを使用して、Web アプリ アーカイブをビルドします。

compiler.build.webAppArchive(opts);

同じオプションをもつファイル ExampleApp2.mlapp を使用してコンパイルするには、ビルド関数を再度実行する前に、ドット表記を使用して既存の WebAppArchiveOptions オブジェクトの AppFile を変更します。

opts.AppFile = 'ExampleApp2.m';

AppFile 引数を変更して再コンパイルすることにより、同じオプション オブジェクトを使用して複数のアーカイブをコンパイルできます。

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

matlabroot\examples\matlab\main にあるファイル 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]

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

入力引数

すべて折りたたむ

メイン ファイルへのパス。行の文字ベクトルまたは string スカラーとして指定します。ファイルは、拡張子が .mlapp である MATLAB アプリである必要があります。このパスは現在の作業ディレクトリを基準とした相対パス、または絶対パスにできます。

例: 'mywebapp.mlapp'

データ型: char | string

Web アプリのビルド オプション。compiler.build.WebAppArchiveOptions オブジェクトとして指定します。

名前と値の引数

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

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

例: 'Verbose','on'

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

例: 'AdditionalFiles',["myvars.mat","myfunc.m"]

データ型: char | string | cell

Web アプリ アーカイブの名前。文字ベクトルまたは string スカラーとして指定します。既定値は AppFile のファイル名です。

例: 'ArchiveName','MyWebApp'

データ型: char | string

データ ファイルを自動的に含めるためのフラグ。'on' または 'off'、もしくは数値または logical の 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off'false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

  • このプロパティを 'on' に設定した場合、特定の関数 (loadfopen など) の入力として指定するデータ ファイルは自動的に Web アプリ アーカイブに含められます。

  • このプロパティを 'off' に設定した場合、データ ファイルは AdditionalFiles プロパティを使用してアーカイブに追加しなければなりません。

例: 'AutoDetectDataFiles','Off'

データ型: logical

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

ビルド フォルダーの既定の名前は、アーカイブ名に webAppArchive を追加したものです。

例: 'OutputDir','D:\Documents\MATLAB\work\mymagicwebAppArchive'

データ型: char | string

含めるサポート パッケージ。次のオプションのいずれかとして指定します。

  • 'autodetect' (既定) — 依存関係の解析プロセスにより、必要なサポート パッケージが自動的に検出され、含められます。

  • 'none' — サポート パッケージは含められません。このオプションを使用すると、ランタイム エラーの原因となる可能性があります。

  • string スカラー、文字ベクトル、または文字ベクトルの cell 配列 — 指定されたサポート パッケージのみが含められます。インストールされている、または特定のファイルで使用されるサポート パッケージのリストを表示するには、compiler.codetools.deployableSupportPackages を参照してください。

.

例: 'SupportPackages',{'Deep Learning Toolbox Converter for TensorFlow Models','Deep Learning Toolbox Model for Places365-GoogLeNet Network'}

データ型: char | string | cell

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

  • このプロパティを 'on' に設定した場合、MATLAB コマンド ウィンドウには、ビルド プロセス中のコンパイラ出力を示す進行状況情報が表示されます。

  • このプロパティを 'off' に設定した場合、コマンド ウィンドウには進行状況の情報は表示されません。

例: 'Verbose','On'

データ型: logical

出力引数

すべて折りたたむ

ビルド結果。compiler.build.Results オブジェクトとして返されます。Results オブジェクトには以下が含まれています。

  • 'webAppArchive' であるビルド タイプ

  • コンパイル済み Web アプリ アーカイブ ファイルへのパス

  • 含まれているサポート パッケージのリスト

  • ビルド オプション。WebAppArchiveOptions オブジェクトとして指定

バージョン履歴

R2020b で導入