C++ 엔진 프로그램 빌드하기

지원되는 컴파일러

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

mex 명령을 사용하여 .cpp 파일 빌드하기

지원되는 컴파일러를 설치했으면 mex 명령을 사용하여 C++ 엔진 응용 프로그램용 컴파일러를 설정하십시오. 컴파일러를 선택하라는 옵션이 제공되면 설치된 컴파일러 중에서 C++용 MATLAB^® Engine API가 지원하는 컴파일러를 선택합니다.

mex -setup -client engine C++

MATLAB mex 명령을 사용하여 C++ 엔진 프로그램을 빌드합니다.

mex -client engine MyEngineCode.cpp

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

일반 요구 사항

다음과 같은 라이브러리, 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

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

Mac 라이브러리

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

엔진 include 파일

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

MatlabEngine.hpp — C++ Engine API에 대한 정의
MatlabDataArray.hpp — MATLAB Data Array에 대한 정의

MATLAB Data Array는 외부 데이터와 MATLAB 사이에 제네릭 인터페이스를 제공하는 클래스와 API의 모음입니다.

런타임 환경

다음 표에는 환경 변수의 이름과 각 플랫폼에 대해 추가할 경로가 나와 있습니다.

운영 체제	변수	경로
Windows	`PATH`	`matlabroot\extern\bin\win64`
64비트 Apple Mac	`DYLD_LIBRARY_PATH`	`matlabroot/extern/bin/maci64`
64비트 Linux	`LD_LIBRARY_PATH`	`matlabroot/extern/bin/glnxa64:matlabroot/sys/os/glnxa64`

참고 항목

mex | matlab::engine::MATLABEngine