툴박스 생성 및 공유

MATLAB^® 파일을 패키징하여 다른 사람과 공유할 툴박스를 만들 수 있습니다. 이러한 파일에는 MATLAB 코드, 데이터, 앱, 예제, 도움말 문서가 포함될 수 있습니다. 툴박스를 만들면 MATLAB은 툴박스를 만든 사람이나 다른 사람이 툴박스를 설치할 수 있게 해 주는 단일 설치 파일(.mltbx)을 생성합니다.

툴박스 생성하기

R2025a부터 툴박스 패키징은 프로젝트와 통합됩니다. 파일에서 툴박스를 만들려면 프로젝트 내에서 툴박스 작업을 만듭니다. 그런 다음 이 툴박스 작업을 사용하여 툴박스를 구성하고 패키징합니다.

R2025a 이전: 툴박스를 만들려면 홈 탭으로 이동하여 환경 섹션에서 애드온 > 툴박스 패키징을 선택합니다. 그런 다음 툴박스 패키징 대화 상자에서 버튼을 클릭하고 툴박스 폴더를 선택합니다. 툴박스를 구성한 다음 패키지를 클릭하여 툴박스 설치 파일을 만듭니다.

툴박스 작업 만들기

툴박스를 만들기 위한 첫 번째 단계는 툴박스 작업을 만드는 것입니다. 그러면 해당 툴박스 작업을 사용하여 툴박스를 구성하고 패키징할 수 있습니다.

툴박스 작업을 만드는 방법에는 다음 두 가지가 있습니다.

이미 툴박스 파일이 프로젝트 내에 포함된 경우 해당 프로젝트를 열고 프로젝트 탭으로 이동한 다음 툴 섹션에서 툴박스 패키징을 클릭하십시오. MATLAB에서 그 프로젝트와 동일한 이름의 툴박스 작업이 생성되고 데스크탑의 문서 영역에서 열립니다.
아직 프로젝트에 파일이 포함되지 않은 경우 홈 탭으로 이동하여 환경 섹션에서 애드온 > 툴박스 패키징을 선택하십시오. 찾아보기를 클릭하여 툴박스 파일이 포함된 폴더를 선택하고 확인을 클릭하십시오. MATLAB에서 파일이 포함된 새 프로젝트와 툴박스 구성을 위한 툴박스 작업이 생성됩니다. 선택한 폴더가 프로젝트에 이미 포함되어 있는 경우 기존 프로젝트가 대신 사용됩니다.

툴박스 작업을 닫은 후 다시 열려면 프로젝트 탭으로 이동한 후 툴박스 패키징을 클릭하십시오. 컴파일러 작업 관리자를 클릭하여 모든 툴박스 작업을 프로젝트에서 볼 수도 있습니다.

툴박스 폴더 지정하기

툴박스 폴더와 툴박스 내에 있는 파일의 미리보기가 툴박스 폴더 섹션에 표시됩니다. 툴박스 폴더를 추가하려면 툴박스 폴더 추가 버튼을 클릭하십시오. 툴박스 폴더를 추가한 후 변경하려면 툴박스 폴더 변경 버튼을 클릭하십시오.

기본적으로 MATLAB은 툴박스에서 소스 컨트롤 파일과 프로젝트 리소스 파일을 제외합니다. 또한 툴박스의 동일한 폴더에 이름이 같은 P 코드 파일과 MATLAB 코드 파일(.m)이 있으면 MATLAB은 툴박스에서 .m 파일을 제외합니다. 제외된 파일을 미리보기에 표시하려면 제외 항목 표시 여부 버튼을 클릭하십시오. 다른 파일 또는 폴더를 툴박스에서 제외하려면 제외 항목 편집 버튼을 클릭한 다음, 열리는 텍스트 파일에 해당 파일이나 폴더를 추가하십시오. 툴박스와 관련된 모든 소스 컨트롤 파일을 제외하는 것이 좋습니다.

툴박스 정보 지정하기

다음 표에 설명된 것처럼 툴박스 정보 섹션에서 툴박스에 대한 정보를 지정할 수 있습니다.

툴박스 폴더에 패키지 정의 파일이 들어 있으면, MATLAB은 툴박스 작업을 생성할 때 설명, 요약, 툴박스 이름과 같은 패키지 정보를 사용하여 툴박스 정보 필드의 일부를 자동으로 미리 채웁니다. 그러면 사용자가 이러한 필드를 추가로 편집할 수 있습니다. 패키지에 대한 자세한 내용은 Create and Manage Packages 항목을 참조하십시오.

툴박스 정보 필드	설명
툴박스 이름	필요한 경우, 툴박스 이름을 입력합니다. 기본적으로 툴박스 이름은 툴박스 폴더의 이름을 따릅니다.
버전	툴박스 버전 번호를 `major.minor.bug.build` 형식으로 입력합니다. `bug`와 `build`는 선택 사항입니다.
작성자 이름, 이메일, 회사	툴박스 작성자의 연락처 정보를 입력합니다.
툴박스 이미지	섹션의 왼쪽 위 코너에 있는 이미지를 가리킨 다음 찾아보기를 클릭하여 툴박스를 나타내는 이미지를 선택합니다. 이미지는 프로젝트 폴더 내에 있어야 합니다.
요약 및 설명	툴박스에 대한 요약과 설명을 입력합니다. 요약 텍스트는 짧게 유지하고 자세한 정보는 설명 텍스트에 추가하는 것이 좋습니다.

툴박스 요구 사항 검토하기

MATLAB은 자동으로 툴박스 파일을 분석하여 툴박스에 포함해야 할 요구 사항을 감지합니다. 툴박스 요구 사항 섹션에 이러한 요구 사항이 표시됩니다. 툴박스에 필요한 모든 파일이 포함되도록 하려면, 표에 설명된 감지된 요구 사항을 검토하고 필요한 경우 경고를 해결하십시오.

Toolbox Requirements 필드	설명
필요한 애드온	툴박스에 필요한 애드온 목록을 지정합니다. 툴박스 설치 시, 지정한 애드온이 다운로드되고 설치됩니다. MATLAB은 툴박스에 필요하다고 확인되는 애드온으로 이 목록을 자동으로 채우며 이에 해당하는 애드온을 기본적으로 모두 지정합니다. 사용자가 특정 애드온을 툴박스와 함께 설치하지 않으려는 경우 이를 선택할 수 있습니다. MATLAB이 목록에 있는 애드온의 설치 정보를 찾지 못할 경우, 다운로드 URL을 입력해야 합니다. 다운로드 URL은 MATLAB이 애드온을 다운로드하고 설치할 수 있는 위치입니다. 툴박스가 설치된 경우 MATLAB은 지정한 URL을 통해 애드온을 설치합니다.
발견된 요구 사항	툴박스 폴더 외부에 있으며 툴박스에 필요한 파일 목록을 지정합니다. MATLAB은 툴박스에 필요하다고 확인되는 파일로 이 목록을 자동으로 채우며 이에 해당하는 파일을 기본적으로 모두 지정합니다. 원하지 않는 파일을 툴박스에서 생략하도록 선택할 수 있습니다. 종속성 분석기에서 분석 보기 버튼을 클릭하여 분석을 확인하십시오. 분석을 다시 실행하려면 다시 분석 버튼을 클릭하십시오.

Toolbox Requirements 필드

설명

필요한 애드온

툴박스에 필요한 애드온 목록을 지정합니다. 툴박스 설치 시, 지정한 애드온이 다운로드되고 설치됩니다. MATLAB은 툴박스에 필요하다고 확인되는 애드온으로 이 목록을 자동으로 채우며 이에 해당하는 애드온을 기본적으로 모두 지정합니다. 사용자가 특정 애드온을 툴박스와 함께 설치하지 않으려는 경우 이를 선택할 수 있습니다.

MATLAB이 목록에 있는 애드온의 설치 정보를 찾지 못할 경우, 다운로드 URL을 입력해야 합니다. 다운로드 URL은 MATLAB이 애드온을 다운로드하고 설치할 수 있는 위치입니다. 툴박스가 설치된 경우 MATLAB은 지정한 URL을 통해 애드온을 설치합니다.

발견된 요구 사항

툴박스 폴더 외부에 있으며 툴박스에 필요한 파일 목록을 지정합니다. MATLAB은 툴박스에 필요하다고 확인되는 파일로 이 목록을 자동으로 채우며 이에 해당하는 파일을 기본적으로 모두 지정합니다. 원하지 않는 파일을 툴박스에서 생략하도록 선택할 수 있습니다.

종속성 분석기에서 분석 보기 버튼을 클릭하여 분석을 확인하십시오. 분석을 다시 실행하려면 다시 분석 버튼을 클릭하십시오.

출력 설정 지정하기

툴박스 설치 파일(.mltbx)의 파일 이름과 경로가 출력 설정 섹션에 표시됩니다. 기본적으로 출력 파일 이름은 툴박스 이름이며 파일 경로는 프로젝트 루트 폴더 내에 있는 release 폴더입니다.

툴박스 설치 파일의 파일 이름과 경로를 변경하려면, 확장자가 .mltbx인 새 파일 이름을 입력하고 찾아보기를 클릭하여 다른 출력 경로를 선택하십시오.

설치 동작 추가하기(선택 사항)

툴박스를 설치할 때 발생하는 추가 동작이 설치 동작 섹션에 표시됩니다. MATLAB 경로와 Java 클래스 경로 설정, 앱 설치, 시작하기 안내서 열기 등이 그러한 동작에 해당됩니다. 이 설치 동작을 표에 설명된 대로 구성할 수 있습니다.

설치 동작 필드	설명
MATLAB 경로	사용자가 툴박스를 설치할 때 사용자의 MATLAB 경로에 추가되는 폴더 목록을 지정합니다. 기본적으로, 이 목록에는 프로젝트 경로에 있는 모든 툴박스 폴더가 포함됩니다. 목록에서 폴더를 지워 사용자 경로에 추가되지 않도록 폴더를 제외시킬 수 있습니다. 툴박스 설치 경로를 관리하려면 프로젝트 경로 관리를 클릭하십시오. 목록을 디폴트 목록으로 재설정하려면 디폴트 경로 복원을 클릭하십시오.
Java 클래스 경로	사용자가 툴박스를 설치할 때 사용자의 Java^® 클래스 경로에 추가되는 Java 파일 목록을 지정합니다. 툴박스를 설치하면 MATLAB 세션 동안 JAR 파일이 동적 경로에 추가됩니다. 툴박스 사용자가 MATLAB을 다시 시작하면 정적 경로에 JAR 파일이 추가됩니다.
앱	툴박스와 관련해 퍼블리시된 설치 가능한 MATLAB 앱을 지정합니다. 사용자의 MATLAB 앱 갤러리에 설치 및 등록된 앱(`.mlapp` 파일)도 지정하려면 추가 버튼을 클릭하고 앱을 선택합니다. 또는, 프로젝트 패널에서 파일을 마우스 오른쪽 버튼으로 클릭한 다음 레이블 추가를 클릭하고 툴박스 작업 메뉴에서 앱 갤러리 파일 레이블을 선택합니다. 툴박스 폴더의 모든 `.mlappinstall` 파일은 사용자의 MATLAB 앱 갤러리에 설치 및 등록되어 있습니다.
시작하기 안내서	툴박스에 대한 시작하기 안내서를 지정합니다. 툴박스 작업이 시작하기 안내서를 인식할 수 있도록 가이드를 툴박스 폴더 내 `doc` 하위 폴더에 `GettingStarted.mlx`라는 라이크 스크립트로 포함시키십시오. 그런 다음 프로젝트 패널에서 파일을 마우스 오른쪽 버튼으로 클릭한 다음 레이블 추가를 클릭하고 툴박스 작업 메뉴에서 시작하기 안내서 레이블을 선택하십시오. 또는 추가 버튼을 클릭하여 `GettingStarted.mlx`를 생성하고 편집할 수도 있습니다. 툴박스 사용자는 애드온 패널에서 툴박스에 대한 옵션 메뉴를 통해 시작하기 안내서를 볼 수 있습니다. 자세한 내용은 애드온을 받고 관리하기 항목을 참조하십시오.

툴박스 이식성 구성하기

사용자가 툴박스를 설치할 때 MATLAB은 툴박스 이식성 섹션의 정보를 사용합니다. 사용자가 지원되지 않는 플랫폼 또는 MATLAB 릴리스를 보유하고 있어 호환성 확인에 실패하면 MATLAB에 경고가 표시됩니다. 하지만 툴박스 설치는 가능합니다.

툴박스 이식성 필드	설명
지원되는 플랫폼	툴박스를 지원하는 플랫폼을 지정합니다. 툴박스를 사용하려면 특정 플랫폼 전용 타사 소프트웨어 또는 하드웨어가 필요하다고 가정해 보겠습니다. MATLAB Online™은 이미지 수집과 기기 제어에 사용되는 장치를 비롯한 하드웨어와 상호 작용을 할 수 없습니다.
릴리스 호환성	툴박스를 지원하는 MATLAB 릴리스를 지정합니다.

타사 소프트웨어 추가하기(선택 사항)

사용자가 툴박스를 설치할 때 사용자 시스템에 설치되는 추가 타사 소프트웨어 ZIP 파일의 목록이 타사 소프트웨어 섹션에 표시됩니다. 툴박스와 함께 설치할 타사 소프트웨어를 추가하려면 추가 버튼을 클릭하고 다음 필드를 지정하십시오.

소프트웨어 이름 — 설치할 때 사용자에게 표시할 이름입니다.
플랫폼 — 추가 소프트웨어가 실행되는 플랫폼입니다.
다운로드 URL — 추가 소프트웨어를 포함하는 ZIP 파일의 URL입니다. 플랫폼마다 서로 다른 다운로드 URL을 지정하려면 각 플랫폼에 대해 항목을 별개로 추가하십시오.
라이선스 URL — 설치할 때 사용자에게 표시할 추가 소프트웨어 라이선스 계약의 URL입니다. 설치 시, 라이선스 계약을 검토하고 이에 동의하라는 메시지가 표시됩니다. 라이선스 계약에 대한 유효한 URL을 지정해야 합니다.

사용자가 툴박스를 설치하면 MATLAB은 addons\Toolboxes\AdditionalSoftware 폴더에 추가적인 모든 타사 소프트웨어를 설치합니다. 여기서 addons는 디폴트 애드온 설치 폴더입니다. 디폴트 애드온 설치 폴더의 위치에 대한 자세한 내용은 애드온을 받고 관리하기 항목을 참조하십시오.

지정된 추가적인 타사 소프트웨어가 설치된 폴더를 참조하는 코드가 툴박스에 포함되어 있다면 이러한 참조가 다른 컴퓨터에서도 동작할 수 있게 만들어 주어야 합니다. 참조를 생성된 함수 toolboxname\getInstallationLocation.mlx에 대한 호출로 바꾸십시오. 여기서 toolboxname은 툴박스의 이름입니다. 예를 들어, mytoolbox라는 툴박스를 만들고 mysoftware라는 추가 소프트웨어의 설치 위치를 참조하려는 경우 다음 코드를

mysoftwarelocation = 'C:\InstalledSoftware\mysoftware\'

아래와 같이 바꿔야 합니다.

mysoftwarelocation = mytoolbox.getInstallationLocation('mysoftware')

툴박스 패키징하기

툴박스 구성 후 툴박스 설치 파일(.mltbx)을 만들려면 다음 단계를 수행하십시오.

툴박스 작업 맨 위에 있는 다시 분석 버튼을 클릭하여 툴박스에 문제가 있는지 검사합니다. 계속 진행하기 전에 모든 오류를 해결합니다.
툴박스 작업의 오른쪽 상단 코너에 있는 툴박스 패키징 버튼을 클릭하여 툴박스 설치 파일(.mltbx)을 만듭니다. MATLAB은 출력 설정 섹션에 지정된 폴더에 그 파일을 만듭니다.

툴박스 공유하기

툴박스를 다른 사람과 공유하려면 툴박스 설치 파일(.mltbx)을 배포하십시오. 설치 파일에는 툴박스 패키징 당시에 추가한 모든 파일이 들어 있습니다. 최종 사용자가 툴박스를 설치할 때 설치 파일을 통해 MATLAB 경로와 기타 설치 세부 사항이 관리됩니다.

툴박스 설치, 제거, 툴박스에 대한 정보 보기와 관련된 내용은 애드온을 받고 관리하기 항목을 참조하십시오.

툴박스 설치 파일을 이메일 메시지에 첨부하거나, 다른 일반적인 파일 공유 방법을 통해(예: MATLAB Central File Exchange에 업로드) 툴박스를 다른 사람과 공유할 수 있습니다. File Exchange에 툴박스를 업로드해 두면 최종 사용자는 MATLAB 내에서 툴박스를 다운로드할 수 있습니다. 자세한 내용은 애드온을 받고 관리하기 항목을 참조하십시오.

참고

툴박스 설치 파일은 지정한 어떤 파일이든 포함할 수 있지만, MATLAB Central File Exchange는 제출된 파일에 대한 추가적인 제한을 둡니다. 데이터 파일과 이미지 파일은 일반적으로 허용됩니다. 하지만 툴박스에 다음 유형의 파일이 포함되어 있으면 File Exchange에 툴박스를 제출할 수 없습니다.

MEX 파일
기타 이진 실행 파일(예: DLL 파일 또는 ActiveX^® 컨트롤)

이전 릴리스에서 만든 툴박스 업그레이드하기

R2025a 이전 릴리스에서 만든 툴박스와 그 툴박스와 연결된 .prj 파일이 있는 경우 MATLAB이 그 툴박스를 프로젝트 워크플로로 자동으로 업그레이드할 수 있습니다.

툴박스를 업그레이드하려면 파일 패널에서 .prj 파일을 더블 클릭하여 엽니다. 그러면 MATLAB이 자동으로 프로젝트를 만들고 기존 툴박스 파일과 정보를 새 툴박스 작업에 추가합니다. 툴박스 패키징하기에 설명된 워크플로에 따라 툴박스 정보를 확인한 다음 툴박스를 패키징합니다.

참고 항목

함수

publish | matlab.addons.toolbox.packageToolbox | matlab.addons.toolbox.toolboxVersion | matlab.addons.toolbox.installToolbox | matlab.addons.toolbox.uninstallToolbox | matlab.addons.toolbox.installedToolboxes