독립 실행형 애플리케이션 컴파일러

독립 실행형 애플리케이션으로 배포하기 위한 MATLAB 프로그램 패키징

R2025a 이후

페이지 내 모두 확장

설명

독립 실행형 애플리케이션 컴파일러는 MATLAB® 프로그램을 MATLAB 외부에서 실행할 수 있는 애플리케이션으로 패키징합니다. 컴파일러 앱에서 사용되는 대화형 메뉴와 대화 상자는 사용자의 사양에 맞게 사용자 정의된 compiler.build 명령을 빌드합니다.

컴파일러 앱의 장점은 다음과 같습니다.

  • 단일 직관적 인터페이스로 배포 작업을 수행할 수 있습니다.

  • MATLAB 프로젝트에서 파일을 정리할 수 있습니다.

  • 프로젝트 상태는 세션 간에 유지됩니다.

  • 미리 채워진 메뉴에서 이전에 저장된 컴파일러 작업을 불러올 수 있습니다.

  • 배포를 위해 인스톨러로 애플리케이션을 패키징할 수 있습니다.

자세한 내용은 Target-Specific Compiler Apps for MATLAB Code Deployment 항목을 참조하십시오.

독립 실행형 애플리케이션 컴파일러 앱 열기

  • MATLAB 툴스트립: 앱 탭의 애플리케이션 배포에서 앱 아이콘을 클릭합니다.

  • MATLAB 명령 프롬프트: standaloneApplicationCompiler를 입력합니다.

예제

파라미터

모두 확장

메인 파일

MATLAB 함수를 구현하는 파일입니다. 파일의 확장자는 .m, .p, .mlx, .mexa64 중 하나여야 합니다.

프로젝트에 추가할 모든 파일은 프로젝트 루트 폴더에 있어야 합니다. MATLAB 함수를 배포 가능한 아카이브에 추가하려면 메인 파일 추가를 클릭하고 MATLAB 파일을 선택하십시오. 프로젝트 패널에서, 선택한 파일에 Design 및 Main File 레이블이 표시됩니다.

애플리케이션 정보

생성된 애플리케이션의 이름입니다.

애플리케이션의 버전 번호입니다.

애플리케이션 작성자의 이름입니다.

애플리케이션 작성자의 이메일 주소입니다.

애플리케이션을 만든 회사의 이름입니다.

애플리케이션에 대한 간단한 설명으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

애플리케이션에 대한 자세한 설명으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

출력 위치

빌드 아티팩트가 생성된 폴더의 경로입니다.

인스톨러가 생성된 폴더의 경로입니다.

실행 파일 세부 정보

생성된 애플리케이션 실행 파일의 이름입니다.

애플리케이션의 플랫폼 및 동작으로, 다음 옵션 중 하나로 지정됩니다.

  • 독립 실행형 애플리케이션 — 실행 시 Windows® 명령 셸을 여는 독립 실행형 애플리케이션을 만듭니다. 실행 파일의 형식은 애플리케이션이 빌드된 플랫폼에 따라 다릅니다.

  • 독립 실행형 Windows 애플리케이션 — AppFile을 사용해 지정된 MATLAB 함수, 클래스 또는 앱을 사용하여 독립 실행형 Windows 전용 애플리케이션을 만듭니다. 이 애플리케이션은 실행 시 Windows 명령 셸을 열지 않으며, 따라서 콘솔 출력이 표시되지 않습니다. 이 옵션은 Windows에서만 사용할 수 있습니다.

명령줄 입력값을 숫자형 값 또는 문자형 벡터로 해석합니다.

  • 앱에 대한 입력값을 MATLAB 문자형 벡터로 간주 — 명령줄 입력값이 MATLAB 문자형 벡터로 처리됩니다. 이는 디폴트 동작입니다.

  • 앱에 대한 입력값을 MATLAB double형 숫자로 간주 — 명령줄 입력값이 MATLAB double형 숫자로 처리됩니다.

배포 가능한 아카이브에 있는 폴더 구조, 파일 이름, 사용자 코드를 난독 처리합니다.

이 속성을 활성화하면 배포 가능한 아카이브의 폴더 구조와 파일 이름이 최종 사용자가 볼 수 없도록 난독 처리되며, .m, .mlapp, .p, .mat, MLX, SFX 및 MEX 파일에 포함된 사용자 코드와 데이터는 아카이브 내의 사용자 패키지에 배치됩니다. 또한, 패키징하기 전에 모든 .m 파일이 P 파일로 변환됩니다.

런타임 중에 MATLAB 코드와 데이터가 복호화되며, 파일 시스템으로 추출되는 대신 사용자 패키지에서 직접 불러옵니다. MEX 파일은 불러오기 전에 사용자 패키지에서 임시로 추출됩니다.

사용자 패키지에 추가 파일 형식을 수동으로 포함하려면 각 파일 형식을 개별 확장 태그로 matlabroot/toolbox/compiler/advanced_package_supported_files.xml 파일에 추가하십시오.

다음은 지원되지 않습니다.

  • ver 함수

  • DLL 등의 외부 라이브러리 호출

  • 별도 프로세스(out-of-process) MATLAB Runtime(MATLAB 데이터 배열용 C++ 공유 라이브러리)

  • MEX 파일의 별도 프로세스(out-of-process) 실행(mexhost, feval, matlab.mex.MexHost)

  • R2023b 이전: v7.3이 아닌 .mat 파일

이 옵션을 활성화하는 것은 mcc에 -j와 -s를 지정하여 사용하는 것과 동일합니다.

이 속성을 활성화하지 않으면 배포 가능한 아카이브가 난독 처리되지 않습니다. 이는 디폴트 동작입니다.

애플리케이션 시작 화면으로 사용되는 이미지 파일로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 시작 화면 아이콘은 400×400픽셀로 크기가 조정됩니다.

애플리케이션의 아이콘으로 사용되는 이미지 파일입니다.

아이콘

애플리케이션을 실행하는 데 필요한 파일

배포 가능한 아카이브에 포함할 지원 패키지입니다. 종속성 분석 프로세스는 필수 지원 패키지를 자동으로 감지하여 포함합니다. 지정된 지원 패키지만 포함됩니다. 설치된 지원 패키지 또는 특정 파일에서 사용하는 지원 패키지를 나열하려면 compiler.codetools.deployableSupportPackages 항목을 참조하십시오.

배포 가능한 아카이브에 포함할 추가 파일 및 폴더입니다. 폴더의 내용을 추가하려면 폴더 추가를 클릭하십시오. 개별 파일을 추가하려면 파일 추가를 클릭하십시오.

배포 가능한 아카이브에 포함할 추가 파일입니다. load 및 fopen과 같은 함수의 입력값으로 제공되는 데이터 파일을 자동으로 포함이 비활성화되어 있지 않은 한, 종속성 분석 프로세스가 필요한 데이터 파일을 자동으로 감지하여 포함합니다.

파일 분석 결과를 보려면 분석 보기를 클릭하십시오. 종속성 분석 프로세스를 다시 수행하려면 다시 분석을 클릭하십시오.

배포 가능한 아카이브에 데이터 파일을 자동으로 포함합니다.

  • 이 속성을 활성화하면 특정 함수(예: load 및 fopen)에 대한 입력값으로 제공하는 데이터 파일이 배포 가능한 아카이브에 자동으로 포함됩니다. 이는 디폴트 옵션입니다.

  • 이 속성을 비활성화할 경우에는 사용자 지정 요구 사항 섹션에서 패키지에 데이터 파일을 추가해야 합니다.

인스톨러 세부 정보

MATLAB Runtime 제공 옵션으로, 다음 중 하나로 지정됩니다.

  • 애플리케이션 설치 중에 mathworks.com에서 MATLAB Runtime을 가져옵니다 — 애플리케이션 설치 중에 인스톨러가 MathWorks® 웹사이트에서 MATLAB Runtime을 다운로드하는 옵션입니다. 이 옵션은 디폴트 동작입니다.

  • 오프라인 설치를 위해 애플리케이션 인스톨러에 MATLAB Runtime을 포함합니다 — MathWorks 웹사이트에 연결하지 않고 애플리케이션 설치 중에 MATLAB Runtime을 설치할 수 있도록 인스톨러 내에 포함하는 옵션입니다. 최종 사용자가 인터넷에 액세스하지 못할 수도 있다고 판단되면 이 옵션을 사용하십시오.

  • 애플리케이션 인스톨러에 MATLAB Runtime을 포함시키지 않습니다 — 애플리케이션 설치 중에 MATLAB Runtime을 설치하지 않는 옵션입니다. 최종 사용자가 다른 방법을 사용하여 MATLAB Runtime을 설치할 거라고 판단되면 이 옵션을 사용하십시오. (R2024a 이후)

참고

가져오기 또는 포함 옵션을 사용할 경우 전체 MATLAB Runtime이 설치됩니다. 하나 이상의 특정 MATLAB Runtime 애플리케이션을 실행할 수 있는 최소의 MATLAB Runtime 인스톨러를 생성하려면 compiler.runtime.customInstaller 항목을 참조하십시오. (R2024b 이후)

생성된 인스톨러의 이름입니다.

애플리케이션이 설치될 폴더의 경로입니다. 이 폴더는 타깃 머신의 %ProgramFiles% 폴더에 있습니다.

애플리케이션 사용 시 추가 요구 사항에 대한 참고 사항입니다.

인스톨러 시작 화면으로 사용되는 이미지 파일로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 시작 화면 아이콘은 400×400픽셀로 크기가 조정됩니다.

인스톨러의 아이콘으로 사용되는 이미지 파일입니다.

인스톨러 로고로 사용되는 이미지 파일로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 이 로고는 112×290픽셀로 크기가 조정됩니다.

버전 내역

R2025a에 개발됨

모두 확장

참고 항목

앱

함수