MATLAB 関数のパッケージ化後に生成されるファイル

MATLAB® Compiler SDK™ を使用してデプロイ可能なコンポーネントを作成するときに、ビルド ターゲットに対応するファイルが出力フォルダーに生成されます。使用するパッケージ化方法によっては、ファイルは出力フォルダーのさまざまなサブフォルダーに配置されることがあります。使用可能なパッケージ化の方法の詳細については、デプロイ オプションの選択を参照してください。MATLAB Compiler™ により生成されるファイルのリストについては、MATLAB 関数のパッケージ化後に生成されるファイルを参照してください。

compiler.build の関数群は、メイン ファイルおよびターゲット タイプに従って名付けられたフォルダーに出力ファイルを配置します。たとえば、magicsquarePythonPackage です。

コンパイラ アプリはコンパイラ タスクに基づいて名付けられたフォルダーを生成し、build という名前のサブフォルダーに出力ファイルを配置します。インストーラーを作成した場合、このアプリでは package サブフォルダーをオプションで作成します。インストーラーは、コンパイル済みコンポーネントの配布に必要なすべてのバイナリ アーティファクトをインストールし、MATLAB Runtime をオプションでインストールします。また、関数 compiler.package.installer を使用して、インストーラーを生成することもできます。MATLAB がマシンにインストールされていないユーザーに、インストーラーが配布されます。

インストーラーを作成しない場合は、コンポーネント タイプに従ってコンポーネントの統合に必要なファイルのセットを手動で配布できます。コンポーネントを使用するアプリケーションの開発と実行を目的としてどのファイルが配布されるかの詳細については、アプリケーション開発者への MATLAB Compiler SDK ファイルの配布を参照してください。

R2025a 以降:コンパイラ アプリの以前のバージョンを使用して生成されるファイルの詳細については、MATLAB 関数のパッケージ化後に生成されるファイル (R2024b)を参照してください。

MATLAB Compiler SDK により生成されるファイル

MATLAB Compiler SDK はビルド出力フォルダーに以下のファイルを生成します。ここにリストされていない中間アーティファクトは、MATLAB ファイルのパッケージ化の結果として生成されます。これらはユーザーにとって重要ではありません。

すべてのターゲット

すべてのデプロイ ターゲットに対して以下のファイルが生成されます。

ファイル説明
buildresult.json

パッケージに含まれる Runtime 依存関係に関する情報を含む JSON ファイル。情報は、compiler.build.Results オブジェクトの RuntimeDependencies プロパティに対応します。 (R2025a 以降)

GettingStarted.html

パッケージ化情報と次のステップが含まれる HTML ファイル。

includedSupportPackages.txt

パッケージに含まれているすべてのサポート ファイルがリストされます。

mccExcludedFiles.log

パッケージに含まれていないすべてのツールボックス関数のリストが含まれるログ ファイル。データ ファイルの除外の詳細については、%#exclude を参照してください。

deploymentLog.html

パッケージ化プロセスに関する情報が含まれている HTML ファイル。

readme.txt

デプロイの前提条件に関する情報と、デプロイ用にパッケージ化するファイルのリストが含まれています。

requiredMCRProducts.txt

パッケージを実行するために必要な製品の製品 ID が含まれています。製品 ID の詳細については、matlab.codetools.requiredFilesAndProducts を参照してください。このファイルは将来のリリースで削除される予定です。

unresolvedSymbols.txt

パッケージ化の際に見つからない依存関係がリストされます。このファイルが空でない場合、必要な依存関係を特定し、それらを検索パスに配置してから再コンパイルする必要があります。

サンプル ファイル (オプション)

パッケージ化の際に含める MATLAB サンプル ファイルごとに、ターゲット言語のサンプル アプリケーションが samples という名前のフォルダーに生成されます。詳細については、Create Sample Code to Call Exported Functionを参照してください。

サンプル生成は次のターゲット タイプでサポートされます。

  • C++ 共有ライブラリ

  • Java® パッケージ

  • .NET アセンブリ

  • Python® パッケージ

ファイル説明
filenameSample1_api.cpp

C++ サンプル アプリケーション。

filenameSample1.java

Java サンプル アプリケーション。

filename.cs

C# .NET サンプル アプリケーション。

filenameSample1.py

Python サンプル アプリケーション。

C 共有ライブラリ

ファイル説明
filename.lib

ユーザー記述の共有ライブラリ用のインポート ライブラリ。

filename.h

ユーザー記述の共有ライブラリ用のヘッダー ファイル。

filename.dll

ユーザー記述の共有ライブラリ用のコード。

C++ 共有ライブラリ

ファイル説明
filename.lib

ユーザー記述の mwArray API 共有ライブラリ用のインポート ライブラリ。

このファイルは、パッケージ化の際に mwArray API を選択すると生成されます。

filename.h

ユーザー記述の mwArray API 共有ライブラリ用のヘッダー ファイル。

filename.dll

ユーザー記述の mwArray API 共有ライブラリ用のコード。

v2:

  • generic_interface:

    • filename.ctf

    • readme.txt

フォルダー v2 にはサブフォルダー generic_interface があります。これには、MATLAB データ API ライブラリのデプロイ可能なアーカイブである ctf ファイルが含まれています。

readme.txt ファイルにはパッケージ化情報があります。

v2 フォルダーは、パッケージ化の際に MATLAB データ API を選択すると生成されます。

COM コンポーネント

ファイル説明
_install.bat

生成された dll ファイルを登録するファイル。

filename_1_0.dll

生成された dll。mwregsvr.exe または regsvr32.exe を使用して登録する必要があります。

.NET アセンブリ

ファイル説明
filename.dll

mwArray API を使用してアクセス可能な、生成されたコンポーネントが含まれるファイル。

filename_overview.html

生成されたコンポーネント用の HTML 概要ドキュメント。コンポーネントにアクセスするための要件や、mwArray クラス階層を使用して引数を生成するための要件が含まれています。

filenameNative.dll

ネイティブ API を使用してアクセス可能な、生成されたコンポーネントが含まれるファイル。

Java パッケージ

ファイル説明

doc:

  • html:

    • filename

      • Class1.html

      • Class1Remote.html

      • FilenameMCRFactory.html

      • packageframe.html

      • package-summary.html

      • packagetree.html

    • allclasses-frame.html

    • allclasses-noframe.html

    • constantvalues.html

    • deprecated-list.html

    • help-doc.html

    • index.html

    • index-all.html

    • overview-tree.html

    • package-list

    • script.js

    • stylesheet.css

フォルダー doc には別のフォルダー html が含まれています。このフォルダーには、パッケージ化された Java アプリケーションのすべてのクラスに関する HTML ドキュメンテーションが含まれています。

filename.jar

ユーザー記述アプリケーション用の Java アーカイブ。

このファイルは、パッケージ化の際に MWArray API を選択すると生成されます。

filename.ctf

ユーザー記述アプリケーション用の Java アーカイブ。

このファイルは、パッケージ化の際に MATLAB データ API を選択すると生成されます。

Python パッケージ

ファイル説明

filename:

  • _init_.py

  • filename.ctf

フォルダー Filename には次のファイルが含まれています。

  • _init_.py — Python パッケージの初期化時に使用されるファイル。

  • filename.ctf — Python パッケージのデプロイ可能なアーカイブ。

pyproject.toml

ビルド システム要件および情報が含まれた構成ファイル。pip でパッケージをビルドする際に使用されます。詳細については、https://packaging.python.org/en/latest/guides/writing-pyproject-toml/ を参照してください。

setup.py

Python パッケージのインストール時に使用されるファイル。

MATLAB Production Server アーカイブ

ファイル説明
filename.ctf

MATLAB Production Server™ 用のデプロイ可能なアーカイブ ファイル。

MATLAB Production Server 用 Excel アドイン

ファイル説明
_install.bat

生成された dll ファイルを登録するファイル。

filename.bas

VBA プロジェクトにインポートできる VBA モジュール ファイル。このファイルは、GenerateVisualBasicFile オプションを有効にした場合にのみ生成されます。

filename.xla

Excel® に直接追加できる Excel アドイン。.bas ファイルと .xla ファイルの両方は必要なく、いずれか 1 つで十分です。このファイルは、GenerateVisualBasicFile オプションを有効にした場合にのみ生成されます。

filename.dll

生成された dll。mwregsvr.exe または regsvr32.exe を使用して登録する必要があります。

参考

|

トピック