Java 엔진 프로그램 빌드하기

일반 요구 사항

엔진 응용 프로그램을 빌드하기 위한 Java^® 환경을 설정하려면 다음을 수행하십시오.

matlabroot/extern/engines/java/jar/engine.jar을 Java 클래스 경로에 추가합니다.
지원되는 버전의 JDK™를 사용하여 엔진 응용 프로그램을 빌드합니다. 버전 정보는 MATLAB Interfaces to Other Languages를 참조하십시오.
JRE™가 JDK와 같은 버전이거나 이후 버전이 되도록 합니다.

Java를 실행하려면 폴더 matlabroot/bin/<arch>를 시스템 환경 변수에 추가하십시오. <arch>는 사용자의 컴퓨터 아키텍처입니다. 예를 들어, 64비트 Microsoft^® Windows^® 컴퓨터의 경우 win64, macOS의 경우 maci64, Linux^®의 경우 glnxa64입니다.

matlabroot는 MATLAB^® matlabroot 명령에 의해 반환되는 값입니다. 이 명령은 MATLAB이 설치된 폴더를 반환합니다.

다음 표에는 환경 변수의 이름과 경로의 값이 나와 있습니다.

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

Windows에서 Java 코드 컴파일하고 실행하기

다음과 같이 Java 코드를 컴파일합니다.

javac -classpath matlabroot\extern\engines\java\jar\engine.jar MyJavaCode.java

Java 프로그램을 실행합니다.

java -classpath .;matlabroot\extern\engines\java\jar\engine.jar MyJavaCode

시스템 경로 설정하기

Windows 명령 프롬프트에서 런타임 라이브러리 경로를 설정하려면 다음 명령을 입력하십시오.

set PATH=matlabroot\bin\win64;%PATH%

Windows 명령 처리기를 열 때마다 경로를 설정하십시오.

시스템 속성 대화 상자에서 PATH 변수를 설정할 수도 있습니다. 제어판 > 시스템 > 고급 시스템 설정 > 고급 탭에서 환경 변수를 클릭합니다. 시스템 변수 아래에서 Path를 선택하고 편집을 클릭합니다. 변수 값 시작 부분에 matlabroot\bin\win64를 삽입하여 Path를 수정합니다. 확인을 클릭하여 대화 상자를 닫은 다음, 제어판 대화 상자를 닫습니다.

macOS에서 Java 코드 컴파일하고 실행하기

Java용 MATLAB Engine API는 macOS 시스템에서 maci64만 지원합니다.

다음과 같이 Java 코드를 컴파일합니다.

javac -classpath matlabroot/extern/engines/java/jar/engine.jar MyJavaCode.java

Java 라이브러리 경로 지정하고 프로그램 실행하기

하나의 명령문에서 Java 라이브러리 경로를 지정하고 Java 프로그램을 실행합니다.

java -Djava.library.path=matlabroot/bin/maci64 -classpath .:matlabroot/extern/engines/java/jar/engine.jar MyJavaCode

시스템 변수 설정하고 프로그램 실행하기

DYLD_LIBRARY_PATH 변수를 설정하고 Java 프로그램을 실행합니다. 예를 들어, C 셸을 사용할 경우 다음을 입력합니다.

setenv DYLD_LIBRARY_PATH matlabroot/bin/maci64:$DYLD_LIBRARY_PATH
java -classpath .:matlabroot/extern/engines/java/jar/engine.jar MyJavaCode

C 셸에서 변수 설정하기

시작 스크립트(예: ~/.cshrc)에 다음 명령을 넣을 수 있습니다.

setenv DYLD_LIBRARY_PATH matlabroot/bin/maci64:$DYLD_LIBRARY_PATH

Bourne 셸에서 변수 설정하기

시작 스크립트(예: ~/.profile)에 다음 명령을 넣을 수 있습니다.

DYLD_LIBRARY_PATH=matlabroot/bin/maci64:$DYLD_LIBRARY_PATH
export DYLD_LIBRARY_PATH

Java 버전 1.8.0의 초기 빌드 사용하기

Java 버전 1.8.0의 초기 빌드(예: 1.8.0_111)를 사용할 경우 DYLD_LIBRARY_PATH 환경 변수를 인식하지 못할 수도 있습니다. java.lang.UnsatisfiedLinkError 예외가 발생하면 java.library.path를 명시적으로 설정하십시오.

java -Djava.library.path=matlabroot/bin/maci64 -classpath .:matlabroot/extern/engines/java/jar/engine.jar MyJavaCode

Linux에서 Java 코드 컴파일하고 실행하기

Java용 MATLAB Engine API는 Linux 시스템에서 glnxa64만 지원합니다.

다음과 같이 Java 코드를 컴파일합니다.

javac -classpath matlabroot/extern/engines/java/jar/engine.jar MyJavaCode.java

Java 라이브러리 경로 지정하고 프로그램 실행하기

호환되는 GCC 라이브러리가 검색 경로에 있는 경우, LD_LIBRARY_PATH 변수를 설정할 필요 없이 matlabroot/bin/glnxa64를 Java 라이브러리 검색 경로에 추가하고 예제를 실행할 수 있습니다. 지원되는 컴파일러에 대한 자세한 내용은 지원 및 호환되는 컴파일러를 참조하십시오.

하나의 명령문에서 Java 라이브러리 경로를 지정하고 Java 프로그램을 실행합니다.

java -Djava.library.path=matlabroot/bin/glnxa64 -classpath .:matlabroot/extern/engines/java/jar/engine.jar MyJavaCode

시스템 변수 설정하고 프로그램 실행하기

LD_LIBRARY_PATH 변수를 설정하고 Java 프로그램을 실행합니다. 예를 들어, C 셸을 사용할 경우 다음을 입력합니다.

setenv LD_LIBRARY_PATH matlabroot/bin/glnxa64:matlabroot/sys/os/glnxa64:$LD_LIBRARY_PATH
java -classpath .:matlabroot/extern/engines/java/jar/engine.jar MyJavaCode

C 셸에서 변수 설정하기

시작 스크립트(예: ~/.cshrc)에 다음 명령을 넣을 수 있습니다.

setenv LD_LIBRARY_PATH matlabroot/bin/glnxa64:matlabroot/sys/os/glnxa64:$LD_LIBRARY_PATH

Bourne 셸에서 변수 설정하기

시작 스크립트(예: ~/.profile)에 다음 명령을 넣을 수 있습니다.

LD_LIBRARY_PATH=matlabroot/bin/glnxa64:matlabroot/sys/os/glnxa64:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH