Main Content

배포를 위한 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 폴더

운영 체제환경 변수디렉터리
WindowsPATH<MATLAB_RUNTIME_INSTALL_DIR>\runtime\<arch>
LinuxLD_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 환경 변수를 영구적으로 설정하십시오.

  1. C:\Windows\System32\SystemPropertiesAdvanced.exe를 실행하고 환경 변수.. 버튼을 클릭합니다.

  2. 시스템 변수 Path를 선택하고 편집..을 클릭합니다.

    참고

    컴퓨터에 대한 관리자 권한이 없으면 시스템 변수 대신 사용자 변수 Path를 선택합니다.

  3. 새로 만들기를 클릭하고 <MATLAB_RUNTIME_INSTALL_DIR>\runtime\<arch> 폴더를 추가합니다.

    예를 들어 64비트 Windows의 디폴트 설치 폴더에 있는 MATLAB Runtime R2024a를 사용하는 경우 C:\Program Files\MATLAB\MATLAB Runtime\R2024a\runtime\win64를 추가합니다.

  4. 변경 사항을 적용하려면 확인를 클릭합니다.

참고

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

Linux

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

Bash 셸

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

    echo $LD_LIBRARY_PATH

  2. 현재 세션의 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"

  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}:}\
    <MATLAB_RUNTIME_INSTALL_DIR>/bin/glnxa64/glibc-2.17_shim.so"

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

macOS

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

    echo $DYLD_LIBRARY_PATH

  2. 현재 세션의 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"

  3. DYLD_LIBRARY_PATH 값을 표시하여 경로가 올바른지 확인합니다.

    echo $DYLD_LIBRARY_PATH

  4. 이러한 변경 사항을 영구적으로 적용하려면 UNIX에서 영구적으로 경로 설정하기 항목을 참조하십시오.

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

주의

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

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

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

관련 항목