Создание и совместное использование тулбоксов

Можно группировать MATLAB® файлы, чтобы создать тулбокс, чтобы совместно использовать с другими. Эти файлы могут включать код MATLAB, данные, приложения, примеры и документацию. Когда вы создаете тулбокс, MATLAB генерирует один файл установки (.mltbx) это позволяет вам или другим установить свой тулбокс.

Создание тулбокса

Создать файл установки тулбокса:

  1. В разделе Environment вкладки Home выберите Package Toolbox из меню Add-Ons.

  2. В диалоговом окне Package a Toolbox нажмите кнопку и выберите свою папку тулбокса. Это - хорошая практика, чтобы создать пакет тулбокса из уровня папки выше вашей папки тулбокса. .mltbx файл тулбокса содержит информацию о настройках path для ваших файлов тулбокса и папок. По умолчанию любая из включенных папок и файлов, которые находятся на вашем пути, когда вы создаете тулбокс, появляется на их путях после того, как конечные пользователи установили тулбокс.

  3. В диалоговом окне добавьте следующую информацию о своем тулбоксе.

    Поле информации о тулбоксеОписание
    ToolboxName

    Введите имя тулбокса при необходимости. По умолчанию имя тулбокса является именем папки тулбокса. Имя Тулбокса становится .mltbx fileName .

    Версия

    Введите номер версии тулбокса в Major.Minor.Bug.Build формат. Bug и Build являются дополнительными.

    Имя автора, электронная почта и компания

    Введите контактную информацию для автора тулбокса. Чтобы сохранить контактную информацию, нажмите Set as default contact.

    Изображение тулбокса

    Чтобы выбрать изображение, которое представляет ваш тулбокс, нажмите Select toolbox image.

    Сводные данные и описание

    Введите сводные данные тулбокса и описание. Это - хорошая практика, чтобы сохранить текстовое резюме Summary и добавить деталь в текст Description.

  4. Гарантировать MATLAB обнаруживает ожидаемые компоненты, рассмотрите содержимое тулбокса. Следующие разделы диалогового окна Package a Toolbox появляются после того, как вы выберете папку тулбокса.

    Группируйте раздел диалогового окна тулбоксаОписание
    Toolbox Files and Folders

    Список папок и файлов содержится в вашем тулбоксе. Перечисленные файлы и папки являются только теми файлами, которые расположены в верхнем уровне папки тулбокса. Вы не можете перейти через папки в диалоговом окне Toolbox Packaging.

    По умолчанию, если ваш тулбокс содержит Pcode-файл и файл кода MATLAB (.m) с тем же именем в той же папке MATLAB исключает .m файл от тулбокса. Включать обоих .p и .m файлы, очистите опцию Exclude MATLAB script or function files with matching P-files.

    Чтобы исключить другие файлы или папки от тулбокса, укажите их в текстовом файле, который отображен, когда вы нажимаете 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-файлов программного обеспечения, которые установлены в системе пользователя, когда они установили тулбокс.

    Задайте эти поля:

    • DisplayName Имя, чтобы отобразиться пользователю, когда они установили тулбокс.

    • License URL — URL дополнительного лицензионного соглашения отобразиться пользователю, когда они установили тулбокс. Пользователю предлагают рассмотреть и согласиться на лицензионное соглашение во время установки. Необходимо задать допустимый URL к лицензионному соглашению.

    • Download URL — URL к zip-файлу, который содержит дополнительное программное обеспечение. Чтобы задать различные URL загрузки для других платформ, выберите имя платформы из выпадающего меню слева от загрузки URL. Затем нажмите Add Platform, чтобы добавить загрузку URL для дополнительных платформ.

    Когда пользователь установил тулбокс, MATLAB устанавливает все дополнительное программное обеспечение в addons\Toolboxes\AdditionalSoftware папка, где addons папка стандартной установки дополнений. Для получения дополнительной информации о местоположении папки стандартной установки дополнений, смотрите, Получают и Управляют Дополнениями.

    Если ваш тулбокс содержит код, который относится к папке установки заданного дополнительного программного обеспечения, сделайте эти ссылки, портативные на другие компьютеры. Замените ссылки на вызовы сгенерированной функции toolboxname\getInstallationLocation.mlx, где toolboxname имя вашего тулбокса. Например, если вы создаете тулбокс под названием mytoolbox и хочу сослаться на местоположение установки для дополнительного программного обеспечения под названием mysoftware, замените этот код

    mysoftwarelocation = 'C:\InstalledSoftware\mysoftware\'
    с этим кодом:
    mysoftwarelocation = mytoolbox.getInstallationLocation('mysoftware')
    Чтобы позволить тестировать тулбокса на вашем компьютере прежде, чем группировать тулбокс, нажмите toolboxname\getInstallationLocation.mlx соединитесь в нижней части раздела Installation of Additional Software и введите установленное местоположение каждой дополнительной части программного обеспечения на вашем компьютере.

    Toolbox Portability

    MATLAB использует информацию в разделе Toolbox Portability, когда пользователь установил тулбокс. Если проверка совместимости перестала работать, потому что у пользователя есть неподдерживаемая платформа или версия MATLAB, MATLAB выводит предупреждение. Однако пользователь все еще может установить тулбокс.

    Совместимость платформ — Список платформ, которые поддерживают тулбокс. Рассмотрите, имеет ли ваш тулбокс стороннее программное обеспечение или требования к аппаратным средствам, которые являются конкретной платформой. MATLAB Online™ не может взаимодействовать с оборудованием, включая устройства, используемые для инструментального управления и получения изображений.

    Совместимость версий — Список релизов MATLAB, которые поддерживают тулбокс.

    Продукты — список MathWorks® продукты требуются вашим тулбоксом. Создайте этот список вручную.

    Examples, Apps, and Documentation

    Примеры — Опубликованные примеры MATLAB сопоставлены с вашим тулбоксом. Включать .m и .mlx файлы как примеры, нажмите кнопку Add examples, выберите свой файл кода и нажмите Publish HTML. MATLAB публикует код в HTML и помещает выходные файлы в html папка.

    В качестве альтернативы можно вручную опубликовать файлы кода в HTML в MATLAB и затем включать файлы кода и файлы HTML в папке тулбокса.

    • Для live скрипта (.mlx) пример, экспортируйте его в HTML. На вкладке Live Editor выберите Save> Export to HTML и сохраните его в папке под названием html.

    • Для скрипта (.m) пример, опубликуйте его в HTML с publish функция. Не задавайте выходную папку при публикации примеров. Для инструмента Package a Toolbox, чтобы распознать примеры, выходная папка должна быть папкой по умолчанию (html).

    Чтобы создать различные категории для ваших примеров, поместите примеры в различные подпапки в вашей папке тулбокса. Когда вы добавляете свою папку тулбокса в диалоговое окно Package a Toolbox, MATLAB создает demos.xml файл, чтобы описать ваши примеры, и берет подымя папки в качестве примера в качестве названия категории в качестве примера. В качестве альтернативы можно создать собственный demos.xml файл. demos.xml файл позволяет получателям получать доступ к вашим примерам через ссылку Supplemental Software в нижней части домашней страницы Браузера документации. Для получения дополнительной информации смотрите Отображение Пользовательские Примеры.

    Приложения — Опубликованный MATLAB устанавливаемые приложения сопоставлен с вашим тулбоксом. Инструмент Package a Toolbox распознает приложения (.mlapp файлы) и файлы установщика приложения (.mlappinstall файлы), и включает их в ваш тулбокс.

    • Задавать который приложения (.mlapp файлы), также установлены и указаны в галерее Apps MATLAB пользователя, выбирают приложения.

    • Весь .mlappinstall файлы в вашей папке тулбокса установлены и зарегистрированы в галерее Apps MATLAB пользователя.

    Начало работы — Руководство по быстрому началу работы для вашего тулбокса. Для инструмента Package a Toolbox, чтобы распознать Начало работы, включайте руководство как live скрипт под названием GettingStarted.mlx в doc подпапка в вашей папке тулбокса.

    В качестве альтернативы можно сгенерировать и отредактировать GettingStarted.mlx от диалогового окна Package a Toolbox.

    Пользователи вашего тулбокса могут просмотреть Начало работы через меню параметров для тулбокса в Add-On Manager. Для получения дополнительной информации смотрите, Получают и Управляют Дополнениями.

    Интегрирование Браузера документации — Пользовательская документация сопоставлена с вашим тулбоксом. Для инструмента Package a Toolbox, чтобы распознать пользовательскую документацию, включайте info.xml файл, чтобы идентифицировать ваши файлы документации. Если вы используете builddocsearchdb функционируйте, чтобы создать базу данных документации прежде, чем группировать ваш тулбокс, можно включать сгенерированный helpsearch подпапка в вашем тулбоксе. info.xml файл и helpsearch папка позволяет получателям получать доступ к вашей документации через ссылку Supplemental Software в нижней части домашней страницы Браузера документации. Для получения дополнительной информации см. Отображение пользовательской документации.

    В качестве альтернативы можно сгенерировать info.xml и helptoc.xml обработайте файлы по шаблону от диалогового окна Package a Toolbox. Чтобы получить доступ к вашей документации через Браузер документации, завершите шаблоны документации и включайте info.xml на пути MATLAB.

  5. Группируйте свой тулбокс.

    • Чтобы сохранить ваш тулбокс, нажмите 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® средства управления. (Файлы данных и файлы изображений обычно приемлемы.)

Смотрите также

| | | | |

Похожие темы