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

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

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

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

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

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

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

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

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

    Версия

    Введите номер версии тулбокса в формат.Minor.Bug.Build Major. 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) также установлены и указаны в Галерее приложений пользователя MATLAB, выберите приложения.

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

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

| | | | |

Похожие темы

Для просмотра документации необходимо авторизоваться на сайте