Можно группировать файлы MATLAB®, чтобы создать тулбокс, чтобы совместно использовать с другими. Эти файлы могут включать код MATLAB, данные, приложения, примеры и документацию. Когда вы создаете тулбокс, MATLAB генерирует один файл установки (.mltbx
), который позволяет вам или другим установить свой тулбокс.
Создать файл установки тулбокса:
В разделе Environment вкладки Home выберите Package Toolbox из меню Add-Ons.
В диалоговом окне Package a Toolbox нажмите кнопку и выберите свою папку тулбокса. Это - хорошая практика, чтобы создать пакет тулбокса из уровня папки выше вашей папки тулбокса. Файл тулбокса .mltbx
содержит информацию о настройках path для ваших файлов тулбокса и папок. По умолчанию любая из включенных папок и файлов, которые находятся на вашем пути, когда вы создаете тулбокс, появляется на их путях после того, как конечные пользователи установили тулбокс.
В диалоговом окне добавьте следующую информацию о своем тулбоксе.
Поле информации о тулбоксе | Описание |
---|---|
ToolboxName | Введите имя тулбокса при необходимости. По умолчанию имя тулбокса является именем папки тулбокса. Имя Тулбокса становится именем файла |
Версия | Введите номер версии тулбокса в |
Имя автора, электронная почта и компания | Введите контактную информацию для автора тулбокса. Чтобы сохранить контактную информацию, нажмите Set as default contact. |
Изображение тулбокса | Чтобы выбрать изображение, которое представляет ваш тулбокс, нажмите Select toolbox image. |
Сводные данные и описание | Введите сводные данные тулбокса и описание. Это - хорошая практика, чтобы сохранить текстовое резюме Summary и добавить деталь в текст Description. |
Гарантировать MATLAB обнаруживает ожидаемые компоненты, рассмотрите содержимое тулбокса. Следующие разделы диалогового окна Package a Toolbox появляются после того, как вы выберете папку тулбокса.
Группируйте раздел диалогового окна тулбокса | Описание |
---|---|
Toolbox Files and Folders | Список папок и файлов содержится в вашем тулбоксе. Перечисленные файлы и папки являются только теми файлами, которые расположены в верхнем уровне папки тулбокса. Вы не можете перейти через папки в диалоговом окне Toolbox Packaging. По умолчанию, если ваш тулбокс содержит Pcode-файл и файл кода MATLAB ( Чтобы исключить другие файлы или папки от тулбокса, укажите их в текстовом файле, который отображен, когда вы нажимаете Exclude files and folders. Это - хорошая практика, чтобы исключить любые файлы системы контроля версий, связанные с вашим тулбоксом. |
Requirements | Дополнения — Список дополнений требуется для вашего тулбокса. Выбранные дополнения загружены и установлены, когда тулбокс установлен. MATLAB автозаполняет этот список с дополнениями, это думает, что дополнение требует и выбирает их всех по умолчанию. Можно принять решение не использовать любые дополнения, которые вы не хотите устанавливать со своим тулбоксом. Если MATLAB не может найти информацию об установке для дополнения в списке, необходимо ввести загрузку URL. URL Загрузки является местоположением, где MATLAB может загрузить и установить дополнение. Когда тулбокс установлен, MATLAB устанавливает дополнение с помощью заданного URL. |
Внешние Файлы — Список файлов потребовал для вашего тулбокса, которые расположены вне папки тулбокса. MATLAB автозаполняет этот список с файлами, это думает, что дополнение требует и выбирает их всех по умолчанию. Можно принять решение не использовать любые файлы, которые вы не хотите в своем тулбоксе. | |
Install Actions | Путь MATLAB — Список папок, которые добавляются к пути MATLAB пользователя, когда они установили тулбокс. По умолчанию список включает любую из папок тулбокса, которые находятся на вашем пути, когда вы создаете тулбокс. Можно исключить папки от того, чтобы быть добавленным до пути пользователя путем очистки их от списка. Чтобы настроить путь для того, когда тулбокс будет установлен, нажмите Manage the current MATLAB path. Чтобы сбросить список к списку по умолчанию, нажмите Reset to the current MATLAB path. |
Путь к классу Java — Список файлов Java®, которые добавляются к пути к классу Java пользователя, когда они установили тулбокс. После установки тулбокса файлы JAR добавляются к динамическому пути на время сеанса работы с MATLAB. Когда пользователь тулбокса перезапускает MATLAB, файлы JAR добавляются к статическому пути. | |
Установка Additional Software — Список дополнительных zip-файлов программного обеспечения, которые установлены в системе пользователя, когда они установили тулбокс. Задайте эти поля:
Когда пользователь установил тулбокс, MATLAB устанавливает все дополнительное программное обеспечение в Если ваш тулбокс содержит код, который относится к папке установки заданного дополнительного программного обеспечения, сделайте эти ссылки, портативные на другие компьютеры. Замените ссылки на вызовы сгенерированного функционального mysoftwarelocation = 'C:\InstalledSoftware\mysoftware\' mysoftwarelocation = mytoolbox.getInstallationLocation('mysoftware') по ссылке | |
Toolbox Portability | MATLAB использует информацию в разделе Toolbox Portability, когда пользователь установил тулбокс. Если проверка совместимости перестала работать, потому что у пользователя есть неподдерживаемая платформа или версия MATLAB, MATLAB выводит предупреждение. Однако пользователь все еще может установить тулбокс. |
Совместимость платформ — Список платформ, которые поддерживают тулбокс. Рассмотрите, имеет ли ваш тулбокс стороннее программное обеспечение или требования к аппаратным средствам, которые являются конкретной платформой. MATLAB Online™ не может взаимодействовать с оборудованием, включая устройства, используемые для инструментального управления и получения изображений. | |
Совместимость версий — Список релизов MATLAB, которые поддерживают тулбокс. | |
Продукты — Список продуктов MathWorks® требуется вашим тулбоксом. Создайте этот список вручную. | |
Examples, Apps, and Documentation | Примеры — Опубликованные примеры MATLAB сопоставлены с вашим тулбоксом. Чтобы включать Также можно вручную опубликовать файлы кода в HTML в MATLAB и затем включать файлы кода и файлы HTML в папке тулбокса.
Чтобы создать различные категории для ваших примеров, поместите примеры в различные подпапки в вашей папке тулбокса. Когда вы добавляете свою папку тулбокса в диалоговое окно Package a Toolbox, MATLAB создает файл |
Приложения — Опубликованный MATLAB устанавливаемые приложения сопоставлен с вашим тулбоксом. Инструмент Package a Toolbox распознает приложения (файлы
| |
Начало работы — Руководство по быстрому началу работы для вашего тулбокса. Для инструмента Package a Toolbox, чтобы распознать Начало работы, включайте руководство как live скрипт под названием Также можно сгенерировать и отредактировать Пользователи вашего тулбокса могут просмотреть Начало работы через меню параметров для тулбокса в Add-On Manager. Для получения дополнительной информации смотрите, Управляют Вашими Дополнениями. | |
Интегрирование Браузера документации — Пользовательская документация сопоставлена с вашим тулбоксом. Для инструмента Package a Toolbox, чтобы распознать пользовательскую документацию, включайте файл Также можно сгенерировать файлы шаблона |
Группируйте свой тулбокс.
Чтобы сохранить ваш тулбокс, нажмите Package наверху диалогового окна Package a Toolbox. Упаковка вашего тулбокса генерирует файл .mltbx
в вашей текущей папке MATLAB.
Чтобы сохранить ваш тулбокс и совместно использовать его на MATLAB Центральный Обмен файлами, выберите Package and Share из меню Package наверху диалогового окна Package a Toolbox. Эта опция генерирует файл .mltbx
в вашей текущей папке MATLAB и открывает веб-страницу для вашего представления тулбокса к Обмену файлами. MATLAB заполняет форму представления Обмена файлами с информацией о тулбоксе. Рассмотрите и представьте форму, чтобы совместно использовать ваш тулбокс на Обмене файлами.
Когда вы создаете тулбокс, MATLAB генерирует файл .prj
, который содержит информацию о тулбоксе и часто сохраняет его. Это - хорошая практика, чтобы сохранить, это сопоставило файл .prj
так, чтобы можно было быстро создать будущие версии тулбокса.
Чтобы совместно использовать ваш тулбокс с другими, дайте им файл .mltbx
. Все файлы, которые вы добавили, когда вы группировали тулбокс, включены в файл .mltbx
. Когда конечные пользователи установили ваш тулбокс, они не должны быть обеспокоены путем MATLAB или другими деталями установки. Файл .mltbx
управляет этими деталями для конечных пользователей.
Для получения информации об установке видят удаление и просмотр информации о тулбоксах, Получают Дополнения и Управляют Вашими Дополнениями.
Можно совместно использовать тулбокс с другими путем присоединения файла .mltbx
к электронному письму или использования любого другого метода, который вы обычно используете, чтобы совместно использовать файлы — такие как загрузка на MATLAB Центральный Обмен файлами. Если вы загружаете свой тулбокс на Обмен файлами, ваши пользователи могут загрузить тулбокс из MATLAB. Для получения дополнительной информации смотрите, Получают Дополнения.
Также можно загрузить тулбокс на Обмен файлами, когда вы группируете его. Выберите Package and Share из меню Package наверху диалогового окна Package a Toolbox.
В то время как файлы .mltbx
могут содержать любые файлы, вы задаете, MATLAB, Центральный Обмен файлами помещает дополнительные ограничения на представления. Если ваш тулбокс содержит какое-либо из следующих, он не может быть подвергнут Обмену файлами:
Файлы MEX.
Другие бинарные исполняемые файлы, такие как DLLs или средства управления ActiveX®. (Файлы данных и файлы изображений обычно приемлемы.)
matlab.addons.toolbox.installToolbox
| matlab.addons.toolbox.installedToolboxes
| matlab.addons.toolbox.packageToolbox
| matlab.addons.toolbox.toolboxVersion
| matlab.addons.toolbox.uninstallToolbox
| publish