C++ 엔진 프로그램 빌드를 위한 요구 사항

지원되는 컴파일러

C++11을 지원하는 컴파일러를 사용하십시오. 지원되는 컴파일러의 최신 목록을 보려면 지원 및 호환되는 컴파일러를 참조하십시오.

`mex` 명령을 사용하여 빌드하기

MATLAB^® 편집기를 사용하여 엔진 애플리케이션 코드를 작성하고 mex 명령을 실행하여 빌드할 수 있습니다. C++ 엔진 애플리케이션용 컴파일러를 설정하려면 다음을 입력하십시오.

mex -setup -client engine C++

C++ 엔진 프로그램 MyEngineCode.cpp를 빌드하려면 다음을 입력하십시오.

mex -client engine MyEngineCode.cpp

설정을 테스트하려면 C++ 빌드 환경 테스트하기 항목을 참조하십시오.

IDE를 사용하여 빌드하기

Microsoft^® Visual Studio^® 또는 Xcode와 같은 IDE(통합 개발 환경)를 사용하여 소스 코드를 작성하려면, 다음 라이브러리와 include 파일을 사용하여 C++ 엔진 애플리케이션 빌드를 위한 환경을 설정하십시오. 엔진 애플리케이션을 사용하려면 엔진 라이브러리 libMatlabEngine, MATLAB Data Array 라이브러리 libMatlabDataArray 및 지원하는 include 파일이 필요합니다.

다음 경로 사양에서는 matlabroot를 MATLAB matlabroot 명령에 의해 반환되는 경로로 바꿉니다.

Windows 라이브러리

아래의 지정된 경로에서 compiler를 microsoft 또는 mingw64로 바꾸십시오.

엔진 라이브러리 — matlabroot\extern\lib\win64\compiler\libMatlabEngine.lib
MATLAB Data Array 라이브러리 — matlabroot\extern\lib\win64\compiler\libMatlabDataArray.lib

macOS 라이브러리

macos를 Apple Silicon이 탑재된 macOS의 경우 maca64로 바꾸고, Intel^®이 탑재된 macOS의 경우 maci64로 바꾸십시오.

엔진 라이브러리 — matlabroot/extern/bin/macos/libMatlabEngine.dylib
MATLAB Data Array 라이브러리 — matlabroot/extern/bin/macos/libMatlabDataArray.dylib

Linux 라이브러리

엔진 라이브러리 — matlabroot/extern/bin/glnxa64/libMatlabEngine.so
MATLAB Data Array 라이브러리 — matlabroot/extern/bin/glnxa64/libMatlabDataArray.so

추가 라이브러리 — pthread

예를 들어, myEngineApp.cpp를 빌드하려면 다음 라이브러리를 사용하십시오. matlabroot를 MATLAB matlabroot 명령에 의해 반환되는 경로로 바꿉니다.

g++ -std=c++11 -I matlabroot/extern/include/ -L matlabroot/extern/bin/glnxa64/ 
    -pthread myEngineApp.cpp -lMatlabDataArray -lMatlabEngine

엔진 include 파일

헤더 파일에는 API 라이브러리에서 액세스하는 루틴에 대한 프로토타입과 함께 함수 선언이 들어 있습니다. 이러한 파일은 matlabroot/extern/include 폴더에 있으며, Windows^®, macOS 및 Linux^® 시스템에서 모두 동일합니다. 엔진 애플리케이션은 다음 파일을 사용합니다.

MatlabEngine.hpp — C++ Engine API에 대한 정의
MatlabDataArray.hpp — C++와 MATLAB 데이터 사이의 제네릭 인터페이스에 대한 정의

MATLAB 데이터 배열은 외부 데이터와 MATLAB 간의 제네릭 인터페이스를 제공하는 클래스와 API의 모음입니다.

런타임 환경

애플리케이션을 실행하려면 다음 환경 변수 중 하나를 지정된 경로로 설정합니다.

운영 체제	변수	경로
Windows	`PATH`	`matlabroot``\extern\bin\win64`
Apple Silicon이 탑재된 macOS	`DYLD_LIBRARY_PATH`	`matlabroot``/extern/bin/maca64`
Intel이 탑재된 macOS	`DYLD_LIBRARY_PATH`	`matlabroot``/extern/bin/maci64`
Linux	`LD_LIBRARY_PATH`	`matlabroot``/extern/bin/glnxa64:``matlabroot``/sys/os/glnxa64`

참고 항목

mex | matlab::engine::MATLABEngine