툴박스 생성 및 공유

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

툴박스 생성하기

툴박스 설치 파일을 만들려면 다음을 수행하십시오.

홈 탭의 환경 섹션에 있는 애드온 메뉴에서 툴박스 패키징을 선택합니다.
툴박스 패키징 대화 상자에서 버튼을 클릭하고 툴박스 폴더를 선택합니다. 툴박스 폴더 위의 폴더 단계에서 툴박스 패키지를 만드는 것이 좋습니다. .mltbx 툴박스 파일에는 툴박스 파일과 폴더의 경로 설정에 대한 정보가 들어 있습니다. 기본적으로, 툴박스 생성 시 경로에 들어있는 폴더와 파일은 최종 사용자가 툴박스를 설치한 후에 최종 사용자의 해당 경로에 나타납니다.

대화 상자에서 툴박스에 대한 다음 정보를 추가합니다.

툴박스 정보 필드	설명
툴박스 이름	필요한 경우, 툴박스 이름을 입력합니다. 기본적으로 툴박스 이름은 툴박스 폴더의 이름을 따릅니다. 툴박스 이름은 `.mltbx` 파일 이름이 됩니다.
버전	툴박스 버전 번호를 `Major`.`Minor`.`Bug`.`Build` 형식으로 입력합니다. `Bug`와 `Build`는 선택 사항입니다.
작성자 이름, 이메일, 회사	툴박스 작성자의 연락처 정보를 입력합니다. 연락처 정보를 저장하려면 디폴트 연락처로 설정을 클릭하십시오.
툴박스 이미지	툴박스를 나타내는 이미지를 선택하려면 툴박스 이미지 선택을 클릭하십시오.
요약 및 설명	툴박스에 대한 요약과 설명을 입력합니다. 요약 텍스트는 짧게 유지하고 자세한 정보는 설명 텍스트에 추가하는 것이 좋습니다.

MATLAB이 필요한 컴포넌트를 감지할 수 있는지 툴박스 내용을 검토합니다. 툴박스 폴더를 선택하면 다음과 같은 툴박스 패키징 대화 상자의 섹션이 나타납니다.

툴박스 패키징 대화 상자 섹션	설명
툴박스 파일과 폴더	툴박스에 포함된 폴더와 파일 목록입니다. 툴박스 폴더의 최상위 수준에 있는 파일과 폴더만 나열됩니다. 툴박스 패키징 대화 상자에서는 폴더를 탐색할 수 없습니다. 기본적으로 툴박스의 동일한 폴더에 이름이 같은 P 코드 파일과 MATLAB 코드 파일(`.m`)이 있으면 MATLAB은 툴박스에서 `.m` 파일을 제외합니다. `.p` 파일과 `.m` 파일을 모두 포함시키려면 P 파일이 일치하는 MATLAB 스크립트 파일이나 함수 파일 제외 옵션 선택을 취소하십시오. 기타 파일 또는 폴더를 툴박스에서 제외하려면 파일과 폴더 제외를 클릭하면 표시되는 텍스트 파일에 제외하고자 하는 파일이나 폴더를 등록하십시오. 툴박스와 관련된 모든 소스 컨트롤 파일을 제외하는 것이 좋습니다.
요구 사항	애드온 — 툴박스에 필요한 애드온 목록입니다. 툴박스 설치 시, 선택한 애드온이 다운로드되고 설치됩니다. MATLAB은 툴박스에 필요하다고 판단되는 애드온으로 이 목록을 자동으로 채우며 이에 해당하는 애드온을 기본적으로 모두 선택합니다. 사용자가 특정 애드온을 툴박스와 함께 설치하지 않으려는 경우 이를 선택할 수 있습니다. MATLAB이 목록에 있는 애드온의 설치 정보를 찾지 못할 경우, 다운로드 URL을 입력해야 합니다. 다운로드 URL은 MATLAB이 애드온을 다운로드하고 설치할 수 있는 위치입니다. 툴박스가 설치된 경우 MATLAB은 지정한 URL을 통해 애드온을 설치합니다.
요구 사항	외부 파일 — 툴박스 폴더 외부에 있으며 툴박스에 필요한 파일 목록입니다. MATLAB은 툴박스에 필요하다고 판단되는 파일로 이 목록을 자동으로 채우며 이에 해당하는 파일을 기본적으로 모두 선택합니다. 원하지 않는 파일을 툴박스에서 생략하도록 선택할 수 있습니다.
설치 동작	MATLAB 경로 — 사용자가 툴박스를 설치할 때 사용자의 MATLAB 경로에 추가되는 폴더 목록입니다. 기본적으로, 이 목록에는 툴박스를 생성할 때 경로에 들어있는 모든 툴박스 폴더가 포함됩니다. 목록에서 폴더를 지워 사용자 경로에 추가되지 않도록 폴더를 제외시킬 수 있습니다. 툴박스가 설치될 때의 경로를 관리하려면 현재 MATLAB 경로 관리를 클릭하십시오. 목록을 디폴트 목록으로 재설정하려면 현재 MATLAB 경로로 재설정을 클릭하십시오.
	Java 클래스 경로 — 사용자가 툴박스를 설치할 때 사용자의 Java^® 클래스 경로에 추가되는 Java 파일 목록입니다. 툴박스를 설치하면 MATLAB 세션 동안 JAR 파일이 동적 경로에 추가됩니다. 툴박스 사용자가 MATLAB을 다시 시작하면 정적 경로에 JAR 파일이 추가됩니다.
	추가 소프트웨어 설치 — 사용자가 툴박스를 설치할 때 사용자 시스템에 설치되는 추가 소프트웨어 ZIP 파일의 목록입니다. 다음 필드를 지정하십시오. 표시 이름 — 사용자가 툴박스를 설치할 때 사용자에게 표시할 이름입니다. 라이선스 URL — 사용자가 툴박스를 설치할 때 사용자에게 표시할 추가 소프트웨어 라이선스 계약의 URL입니다. 설치 시, 라이선스 계약을 검토하고 이에 동의하라는 메시지가 표시됩니다. 라이선스 계약에 대한 유효한 URL을 지정해야 합니다. 다운로드 URL — 추가 소프트웨어를 포함하는 ZIP 파일의 URL입니다. 플랫폼마다 다른 다운로드 URL을 지정하려면 다운로드 URL 왼쪽에 있는 드롭다운 메뉴에서 플랫폼 이름을 선택하십시오. 그런 다음, 플랫폼 추가를 클릭하여 추가 플랫폼에 대한 다운로드 URL을 추가합니다. 사용자가 툴박스를 설치하면 MATLAB은 `addons\Toolboxes\AdditionalSoftware` 폴더에 모든 추가 소프트웨어를 설치합니다. 여기서 `addons`는 애드온 디폴트 설치 폴더입니다. 애드온 디폴트 설치 폴더의 위치에 대한 자세한 내용은 애드온을 받고 관리하기 항목을 참조하십시오. 지정된 추가 소프트웨어가 설치된 폴더를 참조하는 코드가 툴박스에 포함되어 있다면 이러한 참조가 다른 컴퓨터에서도 동작할 수 있게 만들어 주어야 합니다. 참조를 생성된 함수 `toolboxname\getInstallationLocation.mlx`에 대한 호출로 바꾸십시오. 여기서 `toolboxname`은 툴박스의 이름입니다. 예를 들어, `mytoolbox`라는 툴박스를 만들고 `mysoftware`라는 추가 소프트웨어의 설치 위치를 참조하려는 경우 다음 코드를 mysoftwarelocation = 'C:\InstalledSoftware\mysoftware\' 아래와 같이 바꿔야 합니다. mysoftwarelocation = mytoolbox.getInstallationLocation('mysoftware') 툴박스를 패키징하기 전에 컴퓨터에서 툴박스 테스트를 활성화하려면 추가 소프트웨어 설치 섹션 맨 아래에 있는 `toolboxname\getInstallationLocation.mlx` 링크를 클릭하고 컴퓨터에서 각각의 추가 소프트웨어가 설치된 위치를 입력하십시오.
툴박스 이동성	사용자가 툴박스를 설치할 때 MATLAB은 툴박스 이동성 섹션의 정보를 사용합니다. 사용자가 지원되지 않는 플랫폼 또는 MATLAB 버전을 보유하고 있어 호환성 확인에 실패하면 MATLAB에 경고가 표시됩니다. 하지만 툴박스 설치는 가능합니다.
	플랫폼 호환성 — 툴박스를 지원하는 플랫폼 목록입니다. 툴박스를 사용하려면 특정 플랫폼 전용 타사 소프트웨어 또는 하드웨어가 필요하다고 가정해 보겠습니다. MATLAB Online™은 이미지 수집과 기기 제어에 사용되는 장치를 비롯한 하드웨어와 상호 작용을 할 수 없습니다.
	릴리스 호환성 — 툴박스를 지원하는 MATLAB 릴리스 목록입니다.
	제품 — 툴박스에 필요한 MathWorks^® 제품의 목록입니다. 이 목록은 수동으로 작성해야 합니다.
예제, 앱, 문서	예제 — 툴박스와 관련해 퍼블리시된 MATLAB 예제입니다. `.m` 파일과 `.mlx` 파일을 예제로 포함시키려면 예제 추가 버튼을 클릭하고 코드 파일을 선택한 후 HTML 퍼블리시를 클릭하십시오. 그러면 MATLAB이 코드를 HTML로 퍼블리시하고 출력 파일을 `html` 폴더에 넣습니다. 또는 수동으로 MATLAB에서 코드 파일을 HTML로 퍼블리시한 다음, 코드 파일과 HTML 파일을 툴박스 폴더에 포함시켜도 됩니다. 라이브 스크립트(`.mlx`) 예제는 HTML로 내보내십시오. 라이브 편집기 탭에서 저장 > HTML로 내보내기를 선택하고 `html`이라는 폴더에 저장합니다. 스크립트(`.m`) 예제는 `publish` 함수를 사용하여 HTML로 퍼블리시하십시오. 예제를 퍼블리시할 때 출력 폴더를 지정하지 마십시오. 툴박스 패키징 툴이 예제를 인식할 수 있도록, 출력 폴더는 디폴트 폴더(`html`)여야 합니다. 예제에 대해 서로 다른 범주를 만들려면 툴박스 폴더 내의 여러 하위 폴더에 예제를 배치하십시오. 툴박스 폴더를 툴박스 패키징 대화 상자에 추가하면 MATLAB은 예제를 설명하는 `demos.xml` 파일을 만들고, 예제 하위 폴더 이름을 예제 범주 이름으로 사용합니다. 또는 `demos.xml` 파일을 직접 만들 수도 있습니다. `demos.xml` 파일은 받는 사람이 도움말 브라우저 홈 페이지의 왼쪽에 있는 추가 소프트웨어 섹션을 통해 예제에 액세스할 수 있게 해 줍니다. 자세한 내용은 사용자 지정 예제 표시하기 항목을 참조하십시오.
	앱 — 툴박스와 관련해 퍼블리시된 설치 가능한 MATLAB 앱입니다. 툴박스 패키징 툴은 앱(`.mlapp` 파일)과 앱 인스톨러 파일(`.mlappinstall` 파일)을 인식하여 툴박스에 포함시킵니다. 사용자의 MATLAB 앱 갤러리에 설치 및 등록된 앱(`.mlapp` 파일)도 지정하려면 해당 앱을 선택하십시오. 툴박스 폴더의 모든 `.mlappinstall` 파일은 사용자의 MATLAB 앱 갤러리에 설치 및 등록되어 있습니다.
	시작하기 안내서 — 툴박스에 대한 빠른 시작 가이드입니다. 툴박스 패키징 툴이 시작하기 안내서를 인식할 수 있도록 가이드를 툴박스 폴더 내 `doc` 하위 폴더에 `GettingStarted.mlx`라는 라이크 스크립트로 포함시키십시오. 또는 툴박스 패키징 대화 상자에서 `GettingStarted.mlx`를 생성하고 편집할 수도 있습니다. 툴박스 사용자는 애드온 매니저에서 툴박스에 대한 옵션 메뉴를 통해 시작하기 안내서를 볼 수 있습니다. 자세한 내용은 애드온을 받고 관리하기 항목을 참조하십시오.
	도움말 브라우저 연동 — 툴박스와 관련된 사용자 지정 문서입니다. 툴박스 패키징 툴이 사용자 지정 문서를 인식할 수 있도록, 문서 파일을 식별하는 `info.xml` 파일을 포함하십시오. 툴박스 패키징 전에 `builddocsearchdb` 함수를 사용하여 문서 데이터베이스를 빌드하는 경우, 생성된 `helpsearch` 하위 폴더를 툴박스에 포함시킬 수 있습니다. `info.xml` 파일과 `helpsearch` 폴더는 받는 사람이 도움말 브라우저 홈 페이지의 하단에 있는 추가 소프트웨어 링크를 통해 문서에 액세스할 수 있게 해 줍니다. 자세한 내용은 사용자 지정 문서 표시하기 항목을 참조하십시오. 또는, 툴박스 패키징 대화 상자에서 `info.xml` 템플릿 파일과 `helptoc.xml` 템플릿 파일을 생성할 수도 있습니다. 도움말 브라우저를 통해 문서에 액세스하려면 문서 템플릿을 완성한 후 `info.xml`을 MATLAB 경로에 포함시키십시오.

툴박스를 패키징합니다.
- 툴박스를 저장하려면 툴박스 패키징 대화 상자 상단에 있는 패키지를 클릭하십시오. 툴박스를 패키징하면 현재 MATLAB 폴더에 .mltbx 파일이 생성됩니다.
- MATLAB Central File Exchange에서 툴박스를 저장하고 공유하려면 툴박스 패키징 대화 상자 상단에 있는 패키징 메뉴에서 패키징 및 공유를 선택하십시오. 이 옵션은 현재 MATLAB 폴더에 .mltbx 파일을 생성하고, 툴박스를 File Exchange에 제출할 수 있는 웹 페이지를 엽니다. MATLAB은 File Exchange 제출 양식을 툴박스에 대한 정보로 채웁니다. 양식을 검토한 후 제출하여 File Exchange에서 툴박스를 공유합니다.
툴박스를 생성하면 MATLAB은 툴박스에 대한 정보가 포함된 .prj 파일을 생성한 후 이를 자주 저장합니다. 향후에 신속하게 툴박스 수정본을 만들 수 있도록, 이 .prj 파일을 저장하는 것이 좋습니다.

툴박스 공유하기

툴박스를 다른 사람과 공유하려면 .mltbx 파일을 주십시오. .mltbx 파일에는 툴박스 패키징 당시에 추가한 모든 파일이 들어 있습니다. 따라서, 최종 사용자가 툴박스를 설치할 때 MATLAB 경로나 기타 설치 세부 사항에 대해 신경 쓸 필요가 없습니다. .mltbx 파일은 최종 사용자를 위한 이러한 세부 사항을 관리하는 파일입니다.

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

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

또는 툴박스를 패키징할 때 File Exchange에 업로드할 수도 있습니다. 툴박스 패키징 대화 상자 상단의 패키지 메뉴에서 패키징 및 공유를 선택합니다.

참고

.mltbx 파일은 지정한 어떤 파일이든 포함할 수 있지만, MATLAB Central File Exchange는 제출된 파일에 대한 추가적인 제한을 둡니다. 툴박스에 다음 중 하나가 포함되어 있으면 File Exchange에 툴박스를 제출할 수 없습니다.

MEX 파일.
기타 이진 실행 파일(예: DLL 또는 ActiveX^® 컨트롤). (데이터 파일과 이미지 파일은 일반적으로 허용됩니다.)

참고 항목