배포를 위한 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 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 환경 변수를 영구적으로 설정하십시오.

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. 변경 사항을 적용하려면 확인를 클릭합니다.

참고

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

Linux

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

Bash 셸

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

   echo $LD_LIBRARY_PATH

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

   예를 들어, 디폴트 설치 폴더에 있는 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. 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}:}\
   /usr/local/MATLAB/MATLAB_Runtime/R2026a/bin/glnxa64/glibc-2.17_shim.so"

5. 이러한 변경 사항을 영구적으로 적용하려면 영구적으로 라이브러리 경로 설정하기 항목을 참조하십시오.

macOS

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

   echo $DYLD_LIBRARY_PATH

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

   예를 들어, 디폴트 설치 폴더에 있는 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 섹션에서 시스템 속성 대화 상자를 사용하여 영구 PATH를 설정하는 방법을 이미 살펴보았습니다.

Linux 및 macOS

Linux 또는 macOS에서 라이브러리 경로를 영구적으로 설정하려면 다음을 수행하십시오.

1. 다음 명령을 실행하여 셸을 확인합니다.

   echo $SHELL
   

2. 셸 구성 파일에 export 명령을 추가합니다.

   • Bash 셸의 경우, ~/.bash_profile 또는 ~/.bashrc를 편집합니다.

   • Zsh의 경우, ~/.zprofile 또는 ~/.zshrc를 편집합니다.

3. export 명령을 사용하여 위의 Linux 또는 macOS 섹션에서 적절한 디렉터리를 추가합니다.

   예를 들어, Linux에서 Bash 셸과, 디폴트 설치 폴더에 있는 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 배포하기
• Change Environment Variable for Shell Command