デプロイ用の MATLAB Runtime ライブラリ パスの設定

MATLAB^® Compiler™ または MATLAB Compiler SDK™ を使用して生成されたアプリケーションが正常に機能するには、MATLAB Runtime ライブラリにアクセスする必要があります。MATLAB Runtime には、MATLAB インストールを必要とせずにこれらのコンパイルされたアプリケーションを実行できるようにする必須のコンポーネントが用意されています。これらのアプリケーションは、システムのライブラリ パス環境変数を介して必要なライブラリを見つけます。

Windows^® では、MATLAB Runtime 用のインストーラーによって、インストール中にライブラリ パスが自動的に設定されます。Linux^® および macOS システムでは、MATLAB Runtime のインストール後に適切なライブラリ フォルダーをシステム パスに手動で追加します。特定のオペレーティング システムおよびシェル環境用の手順に従ってください。

Linux および macOS 上のスタンドアロン アプリケーションの場合、MATLAB Compiler によって run_application.sh という名前のシェル スクリプトが生成されます。MATLAB Runtime の場所を引数としてそのスクリプトに渡すと、スクリプトによってライブラリ パスが設定されます。スタンドアロン アプリケーションの起動時に、ランタイムの場所を指定するための代替方法としてこのスクリプトを使用します。以下に例を示します。

./run_application.sh <MATLAB_RUNTIME_INSTALL_DIR> [arguments]

メモ

• ライブラリ パスには、MATLAB Runtime の複数のバージョンが含まれている場合があります。シェル スクリプトを使用せずに起動したアプリケーションでは、パスにリストされている最初のバージョンが使用されます。

• ライブラリ パスを変更する前に、現在のパスの値をバックアップとして保存してください。

• MATLAB Runtime のネットワーク インストールを使用している場合は、アプリケーションと MATLAB Runtime のネットワーク ドライブへのデプロイを参照してください。

ライブラリ パスの環境変数と MATLAB Runtime のフォルダー

オペレーティング システム	環境変数	ディレクトリ
Windows	PATH	<MATLAB_RUNTIME_INSTALL_DIR>\runtime\win64
Linux	LD_LIBRARY_PATH	<MATLAB_RUNTIME_INSTALL_DIR>/runtime/glnxa64 <MATLAB_RUNTIME_INSTALL_DIR>/bin/glnxa64 <MATLAB_RUNTIME_INSTALL_DIR>/sys/os/glnxa64 <MATLAB_RUNTIME_INSTALL_DIR>/extern/bin/glnxa64
macOS (Apple シリコン)	DYLD_LIBRARY_PATH	<MATLAB_RUNTIME_INSTALL_DIR>/runtime/maca64 <MATLAB_RUNTIME_INSTALL_DIR>/bin/maca64 <MATLAB_RUNTIME_INSTALL_DIR>/sys/os/maca64 <MATLAB_RUNTIME_INSTALL_DIR>/extern/bin/maca64

Windows

Windows 用の MATLAB Runtime インストーラーは、インストール時にライブラリ パスを自動的に設定します。インストーラーを使用しない場合は、以下の手順を実行して環境変数 PATH を永続的に設定します。

1. C:\Windows\System32\SystemPropertiesAdvanced.exe を実行し、[環境変数...] ボタンをクリックします。

2. システム変数 Path を選択し、[編集...] をクリックします。

   メモ

   マシンの管理者権限がない場合は、システム変数の代わりにユーザー変数 Path を選択します。

3. [新規] をクリックし、フォルダー <MATLAB_RUNTIME_INSTALL_DIR>\runtime\<arch> を追加します。

   たとえば、64 ビット Windows の既定のインストール フォルダーにある MATLAB Runtime R2026a を使用している場合は、C:\Program Files\MATLAB\MATLAB Runtime\R2026a\runtime\win64 を追加します。

4. [OK] をクリックして変更を適用します。

メモ

パスに複数の MATLAB Runtime のバージョンが含まれている場合、アプリケーションではパスにリストされている最初のバージョンが使用されます。

Linux

Bash 以外のシェルにおける環境変数の設定の詳細については、シェルのドキュメンテーションを参照してください。

Bash シェル

1. ターミナルに、LD_LIBRARY_PATH の現在値を表示します。

   echo $LD_LIBRARY_PATH

2. 現在のセッション用に、MATLAB Runtime のフォルダーを変数 LD_LIBRARY_PATH に追加します。

   たとえば、既定のインストール フォルダーにある MATLAB Runtime R2026a を使用している場合は、次のコマンドを使用します。

   export LD_LIBRARY_PATH="${LD_LIBRARY_PATH:+${LD_LIBRARY_PATH}:}\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/runtime/glnxa64:\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/bin/glnxa64:\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/sys/os/glnxa64:\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/extern/bin/glnxa64"

   メモ

   R2025a より前: 低水準グラフィックスの問題を解決するために Mesa Software OpenGL^® のレンダリングが必要な場合は、パスにフォルダー <MATLAB_RUNTIME_INSTALL_DIR>/sys/opengl/lib/glnxa64 を追加します。

3. LD_LIBRARY_PATH の新しい値を表示して、パスが正しいことを確認します。

   echo $LD_LIBRARY_PATH

4. ldd --version と入力して、GNU^® C ライブラリ (glibc) のバージョンを確認します。表示されたバージョンが 2.17 以前の場合は、次のコマンドを使用して <MATLAB_RUNTIME_INSTALL_DIR>/bin/glnxa64/glibc-2.17_shim.so を環境変数 LD_PRELOAD に追加します。

   export LD_PRELOAD="${LD_PRELOAD:+${LD_PRELOAD}:}\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/bin/glnxa64/glibc-2.17_shim.so"

5. これらの変更を永続的なものにする場合は、ライブラリ パスの永続的な設定を参照してください。

macOS

1. ターミナルに、DYLD_LIBRARY_PATH の現在値を表示します。

   echo $DYLD_LIBRARY_PATH

2. 現在のセッション用に、MATLAB Runtime のフォルダーを変数 DYLD_LIBRARY_PATH に追加します。

   たとえば、既定のインストール フォルダーにある MATLAB Runtime R2026a を使用している場合は、次のコマンドを使用します。

   export DYLD_LIBRARY_PATH="${DYLD_LIBRARY_PATH:+${DYLD_LIBRARY_PATH}:}\
   /Applications/MATLAB/MATLAB_Runtime/R2026a/runtime/maca64:\
   /Applications/MATLAB/MATLAB_Runtime/R2026a/bin/maca64:\
   /Applications/MATLAB/MATLAB_Runtime/R2026a/sys/os/maca64:\
   /Applications/MATLAB/MATLAB_Runtime/R2026a/extern/bin/maca64"

3. DYLD_LIBRARY_PATH の値を表示して、パスが正しいことを確認します。

   echo $DYLD_LIBRARY_PATH

4. これらの変更を永続的なものにする場合は、ライブラリ パスの永続的な設定を参照してください。

ライブラリ パスの永続的な設定

Windows

永続的な [パス] 設定については、「Windows」セクションで [システム プロパティ] ダイアログを使用する方法が既に説明されています。

Linux および macOS

Linux または macOS でライブラリ パスを永続的に設定するには、次を行います。

1. 以下を実行してシェルを確認します。

   echo $SHELL
   

2. シェルの構成ファイルに export コマンドを追加します。

   • Bash シェルの場合、~/.bash_profile または ~/.bashrc を編集します。

   • Zsh の場合、~/.zprofile または ~/.zshrc を編集します。

3. export コマンドを使用して、上記の Linux または macOS セクションから適切なディレクトリを追加します。

   たとえば、Bash シェルで Linux を使用しており、既定のインストール フォルダーにある MATLAB Runtime R2026a を使用している場合は、~/.bashrc に次のコマンドを追加します。

   export LD_LIBRARY_PATH="${LD_LIBRARY_PATH:+${LD_LIBRARY_PATH}:}\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/runtime/glnxa64:\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/bin/glnxa64:\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/sys/os/glnxa64:\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/extern/bin/glnxa64"

4. ファイルを保存し、現在のセッションで再読み込みして変更を適用します。

   source ~/.bashrc  # Bash
   source ~/.zshrc   # Zsh
   

注意

MATLAB ライブラリ パスを永続的に設定すると、同じライブラリ パスを使用する他のアプリケーションと競合することがあります。次の代替方法を検討してください。

• テスト中に現在のセッションにのみパスを設定する。

• 実行前に環境を設定する、アプリケーション固有のラッパー スクリプトを使用する。

参考

トピック

• MATLAB Runtime のダウンロードとインストール
• Set MATLAB Library Paths for Testing Deployed Applications
• アプリケーションと MATLAB Runtime のネットワーク ドライブへのデプロイ
• シェル コマンドの環境変数の変更