MATLAB Runtime コンポーネントキャッシュおよびデプロイ可能なアーカイブの組み込み

Java^® を除くすべてのデプロイターゲットの場合、コンパイル済みアプリケーションのデータは既定でデプロイ可能なアーカイブに直接組み込まれ、実行時に一次フォルダーに解凍されます。この一次フォルダーは、MATLAB^® Runtime コンポーネントキャッシュと呼ばれています。コンパイル済みアプリケーションが実行されると、デプロイ可能なアーカイブにあるファイル (CTF ファイル) は MATLAB Runtime コンポーネントキャッシュに解凍されます。Java パッケージを使用したデータ解凍については、Define Embedding and Extraction Options for Deployable Java Archive (MATLAB Compiler SDK)を参照してください。

キャッシュのサイズおよび場所

既定の最大キャッシュサイズは R2024b より前のリリースでは 32 MB であり、R2024b 以降では 1024 MB です。次の表に、コンポーネントキャッシュの既定の場所を示します。

プラットフォーム	R2024b より前	R2024b 以降
Windows^®	`%LOCALAPPDATA%\Temp\%USERNAME%\mcrCache<version>`	`%LOCALAPPDATA%\MathWorks\MatlabRuntimeCache\<release_version>`
Linux^®	`$HOME/.mcrCache<version>`	`$HOME/.MathWorks/MatlabRuntimeCache/<release_version>`
Mac	MATLAB R2020a 以降では、キャッシュは使用されません。アプリバンドルには、実行時に必要なファイルが含まれています。

環境変数を使用した変更オプション

環境変数を使用して、MATLAB Runtime コンポーネントキャッシュの次のオプションを指定できます。

デプロイ可能なアーカイブが自動的に解凍される既定の場所を定義
トラブルシューティングの目的で、デプロイ可能なアーカイブを自動的に解凍する際に使用可能な診断エラー出力オプションを追加
MATLAB Runtime コンポーネントキャッシュサイズをパフォーマンス上の理由により調整

これらの設定を変更するには、次のシステム環境変数を使用します。

環境変数	目的	メモ
MCR_CACHE_ROOT	デプロイ可能なアーカイブの解凍場所に設定すると、この変数はユーザーごとの既定のコンポーネントキャッシュの場所をオーバーライドします。これは組み込みの `.ctf` ファイルのみに当てはまります。	macOS の場合、この変数は MATLAB R2020a 以降で無視されます。アプリバンドルには、実行時に必要なファイルが含まれています。
MCR_CACHE_SIZE	設定すると、この変数は既定のコンポーネントキャッシュサイズをオーバーライドします。	R2024b 以降、この変数の初期制限は 32 M (メガバイト) または 1024 M です。ただし、これは変数を最初に設定した後に変更できます。`mcrcachedir` コマンドの実行により、指定のファイル内に存在する `.max_size` ファイルを、望ましいキャッシュサイズ制限に編集します。

既定の動作のオーバーライド

Java 以外のターゲットの場合は、mcc -C オプションを使用して、生成されるバイナリにデプロイ可能なアーカイブを組み込まないよう mcc に対して指示できます。ログと診断メッセージの方がはるかに視覚的なので、このオプションをデプロイ可能なアーカイブの問題のトラブルシューティングに使用することができます。

コンパイラアプリの [設定] セクションに -c フラグを追加することによって、このオーバーライドを実装することもできます。

関数 compiler.build を使用している場合は、EmbedArchive=false オプションを使用します。

メモ

競合するラッパーとターゲットタイプを指定して mcc を実行すると、-C オプションを mcc に指定した場合と同様に、生成されるコンポーネントにアーカイブは組み込まれません。以下に例を示します。

mcc -W lib:myLib -T link:exe test.m test.c