MATLAB R2026b App Designer 프로젝트를 독립 실행형 맥 앱으로 전달하려면 macOS 환경에서 MATLAB Compiler로 빌드한 뒤, 깨끗한 대상 맥에서 실제 작업을 검증하세요. 실행하는 쪽에는 호환되는 MATLAB Runtime도 필요합니다. 브라우저로 조직 내부에서만 제공하려는 경우에는 Web App을 별도 경로로 검토해야 합니다. MathWorks의 독립 실행형 앱 배포 안내에서 기본 조건을 확인할 수 있습니다.
이 글은 App Designer 프로젝트를 MATLAB 없이 쓸 동료에게 넘기려는 연구생과 연구자, 맥 앱을 빌드하고 검증하는 개발자, 라이선스와 의존성을 확인하는 대학 기술 지원 담당자를 위한 안내입니다.
SECTION 01 준비 단계: 누구에게 어떤 형태로 전달할지 정하세요
먼저 받는 사람이 무엇을 해야 하는지 정해야 합니다. 프로젝트 파일을 공유하는 것과 독립 실행형 앱을 배포하는 것은 다릅니다. 브라우저 사용이 필요하다면 Web App이 후보지만, 이 역시 설치만으로 끝나는 배포 방식은 아닙니다.
| 전달 방식 | 받는 사람에게 필요한 것 | 적합한 상황 | 확인할 제약 |
|---|---|---|---|
| App Designer 프로젝트 공유 | MATLAB과 필요한 제품 | 받는 사람이 코드를 이어서 수정하거나 분석을 재현해야 할 때 | 받는 쪽의 제품 접근과 프로젝트 의존성을 확인해야 합니다 |
| 독립 실행형 맥 앱 | 호환되는 MATLAB Runtime | MATLAB을 직접 실행하지 않는 사람이 데스크톱 앱을 쓸 때 | Compiler로 빌드하고 대상 맥에서 Runtime과 실행 조건을 검증해야 합니다 |
| Web App | 배포에 맞는 서버 환경과 브라우저 | 관리되는 서버를 통해 조직 내부에서 이용할 때 | 서버 구성과 보안 경계를 별도로 검토해야 합니다 |
App Designer에서 프로젝트 파일을 공유하는 절차와 Compiler를 이용한 독립 실행형 배포는 목적이 다릅니다. App Designer 앱 공유 문서를 참고해 원본 공유가 요구에 맞는지 먼저 판단하세요.
이번 주 권장 작업: 프로젝트를 복사해 의존성을 기록하고, 라이선스와 대상 맥 조건을 확인한 뒤 작은 대표 입력으로 빌드 경로를 시험하세요. 앱이 만들어졌다는 사실만으로 결과의 정확성이나 배포 권한까지 확인되는 것은 아닙니다.
프로젝트 파일만 공유하면 안 되나요?
받는 사람이 MATLAB에서 앱을 수정하거나 MATLAB 작업 공간에서 연구 과정을 재현해야 한다면 프로젝트 공유가 적합할 수 있습니다. 하지만 받는 사람에게 MATLAB 사용 환경이 없다면 프로젝트 파일만 전달해도 독립 실행형 앱처럼 실행할 수 있는 것은 아닙니다.
MATLAB이 없는 동료가 앱을 실행하도록 하려면 Compiler 기반 배포를 검토하세요. 독립 실행형 앱은 MATLAB 자체를 포함하는 방식이 아니므로, 실행에 필요한 MATLAB Runtime 조건을 따로 확인해야 합니다. Runtime은 MATLAB과 분리된 실행 환경이며, 설치와 운영 조건은 MathWorks의 MATLAB Runtime 안내에서 확인할 수 있습니다.
SECTION 02 빌드 전 단계: 의존성과 대상 맥을 점검하세요
App Designer의 주 파일만으로 앱이 완성된다고 가정하면 누락된 파일이나 함수 때문에 빌드 또는 실행이 실패할 수 있습니다. 프로젝트를 원본과 분리해 복구 가능한 복사본으로 준비하고, 아래 항목을 목록으로 만드세요.
.mlapp주 파일과 프로젝트에서 호출하는 MATLAB 함수- 읽어 오거나 저장하는 데이터, 설정 파일, 이미지 등 외부 자원
- 사용하는 툴박스와 지원 패키지
- 파일 경로를 조합하거나 현재 폴더에 의존하는 코드
- 대상 맥의 macOS 버전과 처리기 종류, Runtime 호환 조건
Compiler가 분석한 의존성은 실제 입력 파일과 작업 경로까지 모두 빠짐없이 보장하는 목록으로 취급하지 마세요. Compiler 의존성 분석 문서를 활용하되, 분석 결과와 프로젝트에서 직접 확인한 자료를 함께 대조해야 합니다. 컴파일할 수 없는 기능이나 배포 제한이 있는지도 Compiler 제한 사항에서 점검하세요.
라이선스도 빌드 시작 전에 담당 부서에 확인해야 합니다. 팀이 MATLAB과 MATLAB Compiler를 사용할 권한이 있는지, 특히 원격 환경에서의 사용이 학교나 기관의 조건에 맞는지 확인하세요. 문서에 배포 경로가 나와 있다는 사실만으로 학교 라이선스가 특정 원격 맥에 적용된다고 단정할 수는 없습니다.
대상 맥의 지원 범위는 고정된 것으로 가정하지 마세요. 빌드하려는 릴리스에 맞춰 MathWorks의 맥 시스템 요구 사항과 Runtime 설치 안내를 확인하고, 실제 대상 환경의 macOS와 처리기 구성이 그 조건에 맞는지 기록하세요.
SECTION 03 빌드와 첫 검증: 생성물이 아니라 동작을 확인하세요
MATLAB R2026b App Designer 프로젝트는 어떻게 맥 앱으로 패키징하나요?
R2026b의 App Designer 앱을 독립 실행형으로 배포할 때는 macOS 환경에서 MATLAB Compiler를 사용하세요. MathWorks의 App Designer 독립 실행형 앱 안내를 기준으로 빌드 입력과 포함할 파일을 지정하고, 빌드 로그와 사용한 프로젝트 복사본을 함께 보관합니다.
작업 순서는 다음과 같이 잡을 수 있습니다.
- 원본을 보존하고 별도의 프로젝트 복사본에서 빌드합니다.
- 주 앱 파일과 호출 함수, 외부 데이터를 목록과 대조합니다.
- Compiler의 의존성 분석 결과를 검토하고 포함할 자료를 명시합니다.
- 빌드를 실행한 뒤, 누락된 함수·데이터 파일·툴박스 의존성을 각각 기록합니다.
- 실행 파일뿐 아니라 빌드 로그, 사용한 설정, 배포에 필요한 Runtime 정보를 인계 자료로 저장합니다.
- 생성물을 빌드한 환경에서 시작하고 대표적인 분석 흐름을 실행합니다.
첫 실행에서 문제가 나면 로그를 보존하고 원인을 분리하세요. 함수가 검색 경로에 없어 생긴 문제인지, 외부 자료가 패키지에서 빠졌는지, 사용 기능이 배포에 제한되는지에 따라 해결 방법이 달라집니다. 단순히 설치 파일이 생성됐다는 이유로 작업을 완료 처리하지 마세요.
빌드한 맥 앱은 어떻게 연구 결과까지 재검증하나요?
빌드 환경에서 앱이 열리는 것과 연구 결과가 원본 MATLAB 프로젝트와 일치하는 것은 별개의 검증입니다. 민감한 연구 자료 대신 비식별화했거나 합성한 입력을 준비하고, 원본 프로젝트가 계산한 기준 결과와 패키징된 앱의 결과를 비교하세요.
| 검증 항목 | 확인할 동작 | 기록할 증거 |
|---|---|---|
| 화면과 조작 | 주요 창, 입력 요소, 그래프 조작 | 사용한 입력과 화면 캡처 |
| 데이터 불러오기 | 지원하는 형식과 경로에서 파일 읽기 | 파일명, 경로 조건, 오류 메시지 |
| 분석 흐름 | 대표 분석을 끝까지 실행 | 원본 기준 결과와 앱 결과의 대조 기록 |
| 실패 처리 | 잘못된 입력이나 파일 누락에 대응 | 오류 안내와 복구 가능 여부 |
| 결과 내보내기 | 저장 경로와 결과 파일 생성 | 출력 파일과 다시 열어 본 결과 |
경로가 개발자의 작업 폴더를 가리키지 않는지 확인하세요. 다른 사용자가 접근할 수 없는 폴더나 로컬 설정 파일에 의존하면 대상 맥에서 앱이 시작돼도 실제 작업은 중단될 수 있습니다. 이처럼 앱 실행 성공과 결과 검증을 분리하는 과정은 매뉴얼에 적힌 설치 순서만 따라서는 놓치기 쉬운 점검입니다.
SECTION 04 대상 맥 인계 단계: Runtime 설치와 전달 경로를 결정하세요
MATLAB이 없는 사람도 패키징된 앱을 실행할 수 있나요?
실행할 수 있지만, 독립 실행형 앱이라는 이유만으로 Runtime 조건이 없어지는 것은 아닙니다. 받는 사람의 맥에 앱과 호환되는 MATLAB Runtime을 준비하고, 설치 방법과 지원 조건을 공식 안내에 따라 확인해야 합니다. MATLAB Runtime 설치 절차를 대상 환경과 대조하세요.
앱을 빌드한 컴퓨터와 분리된 맥에서 시험해야 합니다. 개발자 계정의 환경 변수, 이미 설치된 파일, 작업 폴더에 우연히 존재하는 데이터가 앱을 정상 작동하는 것처럼 보이게 할 수 있기 때문입니다. 가능하면 연구에 쓰는 대표 프로젝트의 복사본으로 파일 불러오기, 그래픽 조작, 분석 실행, 결과 저장까지 확인하고 실패 조건도 기록하세요. 이는 특정 프로젝트가 공식 지원 문서만으로 검증됐다고 가정하지 않기 위한 절차입니다.
실행 방식은 어떤 조건에서 고르면 될까요?
- 받는 사람이 MATLAB에서 코드를 수정해야 한다면 프로젝트 공유를 선택하세요. 받는 쪽의 MATLAB과 제품 사용 조건을 먼저 확인해야 합니다.
- 받는 사람에게 MATLAB이 없고 맥에서 데스크톱 작업을 해야 한다면 MATLAB Compiler와 MATLAB Runtime을 쓰는 독립 실행형 앱을 검토하세요. 대상 맥에서 설치와 실제 작업을 시험하세요.
- 사용자가 브라우저로 접속해야 하고 관리 가능한 서버가 있다면 Web App 경로를 검토하세요. Web App 배포 문서는 별도 서버 조건을 다루며, 공식 안내의 배포 경계를 확인해야 합니다.
- 공개 인터넷에서 누구나 접속하는 서비스를 계획한다면 기본 Web App 경로로 바로 진행하지 마세요. MathWorks는 Web App의 안전한 배포 안내에서 신뢰할 수 있는 내부 네트워크 환경을 전제로 보안 조건을 설명합니다.
이 조건 분기를 통해 전달 형식을 좁힌 뒤, 아래 세 가지를 완료해야 인계할 수 있습니다.
- 대상 맥의 시스템과 Runtime 호환 조건을 기록합니다.
- 대표 입력으로 앱을 실행하고 원본 기준 결과와 대조합니다.
- 받는 사람에게 설치 순서, 필요한 Runtime, 지원하는 입력과 알려진 실패 조건을 전달합니다.
SECTION 05 실험실에 맥이 없다면 검증 환경을 어떻게 마련할까요?
구성 선택은 실험실에 이미 있는 장비, 사용 기간, 물리적 연결 장치가 필요한지에 따라 달라집니다. 장기간 계속 사용하는 안정적인 개발 장비가 필요하거나 장비를 직접 연결해야 한다면 맥 실기기를 마련하는 편이 맞을 수 있습니다. 이미 쓸 수 있는 맥이 있다면 그 장비로 빌드하고 검증하는 것이 추가 환경을 준비하지 않는 가장 단순한 선택입니다.
반대로 실험실 장비가 리눅스나 윈도우뿐이라면, 그 장비에서 맥용 앱을 최종 검증했다고 간주할 수 없습니다. 다른 선택지는 맥을 구매하는 것과 원격 맥 환경을 필요한 기간만 사용하는 것입니다. 원격 환경은 구매 전용 비용과 보관 부담을 피하고 단기 빌드·재검증에 활용할 수 있지만, 네트워크 연결과 화면 전송 지연에 영향을 받을 수 있고 물리 장비 연결이 필요한 작업에는 맞지 않을 수 있습니다.
먼저 VPSNIX 요금 정보에서 이용 조건을 확인하고, 원격 환경의 접속과 사용 절차는 VPSNIX 도움말 안내에서 함께 살펴보세요. MATLAB 및 Compiler 사용 권한은 기관 담당자와 별도로 대조하세요. 원격 macOS 환경은 빌드와 대상 조건 검증을 위한 선택지이지, 실제 받는 사람의 맥에서 수행해야 할 최종 인계를 대신하지 않습니다. 이용 기간이 짧고 실험실에 검증 가능한 맥이 없다면 VPSNIX 원격 맥으로 빌드와 재검증 환경을 마련할 수 있습니다. 반면 상시 사용이나 물리적 연결이 필수라면 직접 맥을 마련하는 편이 더 적합할 수 있습니다.