배포를 위한 MATLAB Runtime 경로 설정

MATLAB^® Compiler™ 또는 MATLAB Compiler SDK™로 생성된 애플리케이션은 시스템 라이브러리 경로를 사용하여 MATLAB Runtime 라이브러리를 찾습니다. Windows^®용 MATLAB Runtime 인스톨러는 설치 중에 라이브러리 경로를 자동으로 설정하지만 Linux^® 또는 macOS에서는 라이브러리를 수동으로 추가해야 합니다. MATLAB Runtime을 설치한 후 운영 체제 및 셸 환경에 대한 지침에 따라 시스템 라이브러리 경로에 런타임 폴더를 추가합니다.

또는 MATLAB Runtime의 위치를 Linux 또는 macOS의 관련 셸 스크립트(run_application.sh)에 대한 입력으로 전달하여 애플리케이션을 시작할 수 있습니다.

참고

라이브러리 경로에는 여러 버전의 MATLAB Runtime이 포함될 수 있습니다. 셸 스크립트를 사용하지 않고 시작된 애플리케이션은 경로에 나열된 첫 번째 버전을 사용합니다.
현재 라이브러리 경로 값을 수정하기 전에 백업으로 저장하십시오.
MATLAB Runtime의 네트워크 설치를 사용하는 경우 MATLAB Runtime의 네트워크 설치를 사용하여 애플리케이션 실행 항목을 참조하십시오.

라이브러리 경로 환경 변수 및 MATLAB Runtime 폴더

운영 체제	환경 변수	디렉터리
Windows	`PATH`	`<MATLAB_RUNTIME_INSTALL_DIR>\runtime\<arch>`
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(Intel^® 프로세서)	`DYLD_LIBRARY_PATH`	`<MATLAB_RUNTIME_INSTALL_DIR>/runtime/maci64` `<MATLAB_RUNTIME_INSTALL_DIR>/bin/maci64` `<MATLAB_RUNTIME_INSTALL_DIR>/sys/os/maci64` `<MATLAB_RUNTIME_INSTALL_DIR>/extern/bin/maci64`
macOS(Apple Silicon)	`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 환경 변수를 영구적으로 설정하십시오.

C:\Windows\System32\SystemPropertiesAdvanced.exe를 실행하고 환경 변수.. 버튼을 클릭합니다.
시스템 변수 Path를 선택하고 편집..을 클릭합니다.

참고
컴퓨터에 대한 관리자 권한이 없으면 시스템 변수 대신 사용자 변수 Path를 선택합니다.
새로 만들기를 클릭하고 <MATLAB_RUNTIME_INSTALL_DIR>\runtime\<arch> 폴더를 추가합니다.
예를 들어 64비트 Windows의 디폴트 설치 폴더에 있는 MATLAB Runtime R2024a를 사용하는 경우 C:\Program Files\MATLAB\MATLAB Runtime\R2024a\runtime\win64를 추가합니다.
변경 사항을 적용하려면 확인를 클릭합니다.

참고

경로에 여러 버전의 MATLAB Runtime이 포함되어 있는 경우 애플리케이션은 경로에 나열된 첫 번째 버전을 사용합니다.

Linux

Bash 이외의 셸에서 환경 변수를 설정하는 방법에 대한 자세한 내용은 셸 문서를 참조하십시오.

Bash 셸

터미널에 LD_LIBRARY_PATH의 현재 값을 표시합니다.
```
echo $LD_LIBRARY_PATH
```

현재 세션의 LD_LIBRARY_PATH 변수에 MATLAB Runtime 폴더를 추가합니다.

export LD_LIBRARY_PATH="${LD_LIBRARY_PATH:+${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"

참고

로우 레벨 그래픽스 문제를 해결하기 위해 Mesa Software OpenGL^® 렌더링이 필요한 경우 <MATLAB_RUNTIME_INSTALL_DIR>/sys/opengl/lib/glnxa64 폴더를 경로에 추가합니다. 자세한 내용은 로우 레벨 그래픽스 문제 해결 항목을 참조하십시오.

예를 들어, 디폴트 설치 폴더에 있는 MATLAB Runtime R2024a를 사용하고 있다면 다음 명령어를 사용합니다.

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

LD_LIBRARY_PATH의 새 값을 표시하여 경로가 올바른지 확인합니다.
```
echo $LD_LIBRARY_PATH
```
GNU^® C 라이브러리(glibc) 버전을 확인하려면 ldd --version을 입력합니다. 표시된 버전이 2.17 이하인 경우 다음 명령을 사용하여 LD_PRELOAD 환경 변수에 <MATLAB_RUNTIME_INSTALL_DIR>/bin/glnxa64/glibc-2.17_shim.so를 추가합니다.
```
export LD_PRELOAD="${LD_PRELOAD:+${LD_PRELOAD}:}\
<MATLAB_RUNTIME_INSTALL_DIR>/bin/glnxa64/glibc-2.17_shim.so"
```
이러한 변경 사항을 영구적으로 적용하려면 UNIX에서 영구적으로 경로 설정하기 항목을 참조하십시오.

macOS

터미널에 DYLD_LIBRARY_PATH의 현재 값을 표시합니다.
```
echo $DYLD_LIBRARY_PATH
```

현재 세션의 DYLD_LIBRARY_PATH 변수에 MATLAB Runtime 폴더를 추가합니다.

Intel 프로세서 기반 macOS의 경우 다음 명령을 사용합니다.

export DYLD_LIBRARY_PATH="${DYLD_LIBRARY_PATH:+${DYLD_LIBRARY_PATH}:}\
<MATLAB_RUNTIME_INSTALL_DIR>/runtime/maci64:\
<MATLAB_RUNTIME_INSTALL_DIR>/bin/maci64:\
<MATLAB_RUNTIME_INSTALL_DIR>/sys/os/maci64:\
<MATLAB_RUNTIME_INSTALL_DIR>/extern/bin/maci64"

Apple Silicon 기반 macOS의 경우 다음 명령을 사용합니다.

export DYLD_LIBRARY_PATH="${DYLD_LIBRARY_PATH:+${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"

예를 들어 기본 설치 폴더에 있는 Intel 프로세서 기반 macOS에서 MATLAB Runtime R2024a를 사용하는 경우 다음 명령을 사용합니다.

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

DYLD_LIBRARY_PATH 값을 표시하여 경로가 올바른지 확인합니다.
```
echo $DYLD_LIBRARY_PATH
```
이러한 변경 사항을 영구적으로 적용하려면 UNIX에서 영구적으로 경로 설정하기 항목을 참조하십시오.

UNIX에서 영구적으로 경로 설정하기

주의

MATLAB Runtime 라이브러리는 라이브러리 경로를 사용하는 다른 애플리케이션과 충돌할 수 있습니다. 이 경우 현재 세션에 대해서만 경로를 설정하거나 생성된 셸 스크립트를 사용하여 MATLAB Compiler 애플리케이션을 실행해야 합니다.

Linux 또는 macOS에 로그인할 때 환경 변수를 설정하려면 export 명령을 Bash 셸의 셸 구성 파일 ~/.bash_profile 또는 Zsh 셸의 ~/.zprofile에 추가합니다.

현재 셸 환경을 확인하려면 echo $SHELL을 입력합니다.