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

Можно группировать файлы 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 являются дополнительными.

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

    Введите контактную информацию для автора тулбокса. Чтобы сохранить контактную информацию, нажмите установленный по умолчанию контакт.

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

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

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

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

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

    Группируйте раздел диалогового окна тулбоксаОписание
    Файлы тулбокса и папки

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

    По умолчанию, если ваш тулбокс содержит Pcode-файл и файл кода MATLAB (.m) с тем же именем в той же папке, MATLAB исключает файл .m из тулбокса. Чтобы включать и .p и файлы .m, очистите Исключить скрипт MATLAB или функциональные файлы с соответствием с опцией P-файлов.

    Чтобы исключить другие файлы или папки от тулбокса, укажите их в текстовом файле, который отображен, когда вы нажимаете файлы Exclude и папки. Это - хорошая практика, чтобы исключить любые файлы системы контроля версий, связанные с вашим тулбоксом.

    Внешние файлы

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

    Установите действия

    Путь MATLAB — Список папок, которые добавляются к пути MATLAB пользователя, когда они установили тулбокс. По умолчанию список включает любую из папок тулбокса, которые находятся на вашем пути, когда вы создаете тулбокс. Можно исключить папки от того, чтобы быть добавленным до пути пользователя путем очистки их от списка. Чтобы настроить путь для того, когда тулбокс установлен, нажмите, настраивают текущий путь MATLAB. Чтобы сбросить список к списку по умолчанию, нажмите Reset к текущему пути MATLAB.

    Путь к классу Java — Список файлов Java®, которые добавляются к пути к классу Java пользователя, когда они установили тулбокс. После установки тулбокса файлы JAR добавляются к динамическому пути на время сеанса работы с MATLAB. Когда пользователь тулбокса перезапускает MATLAB, файлы JAR добавляются к статическому пути.

    Установка Дополнительного программного обеспечения — Список дополнительных zip-файлов программного обеспечения, которые установлены в системе пользователя, когда они установили тулбокс.

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

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

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

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

    Мобильность тулбокса

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

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

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

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

    Примеры, приложения и документация

    Примеры — Опубликованные примеры MATLAB сопоставлены с вашим тулбоксом. Чтобы включать .m и файлы .mlx как примеры, нажмите кнопку Add в качестве примера, выберите свой файл кода и нажмите 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 позволяет получателям получать доступ к вашим примерам через ссылку Дополнительного программного обеспечения в нижней части домашней страницы Браузера документации. Для получения дополнительной информации смотрите Отображение Пользовательские Примеры.

    Приложения — Опубликованный 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 позволяют получателям получать доступ к вашей документации через ссылку Дополнительного программного обеспечения в нижней части домашней страницы Браузера документации. Для получения дополнительной информации см. Отображение пользовательской документации.

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

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

    • Чтобы сохранить ваш тулбокс, нажмите Package наверху диалогового окна Package a Toolbox. Упаковка вашего тулбокса генерирует файл .mltbx в вашей текущей папке MATLAB.

    • Чтобы сохранить ваш тулбокс и совместно использовать его на MATLAB Центральный Exchange Файла, выберите Package и Share из меню Package наверху диалогового окна Package a Toolbox. Эта опция генерирует файл .mltbx в вашей текущей папке MATLAB и открывает веб-страницу для вашего представления тулбокса к Exchange Файла. MATLAB заполняет форму представления Exchange Файла с информацией о тулбоксе. Рассмотрите и представьте форму, чтобы совместно использовать ваш тулбокс на Exchange Файла.

    Когда вы создаете тулбокс, MATLAB генерирует файл .prj, который содержит информацию о тулбоксе и часто сохраняет его. Это - хорошая практика, чтобы сохранить, это сопоставило файл .prj так, чтобы можно было быстро создать будущие версии тулбокса.

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

Чтобы совместно использовать ваш тулбокс с другими, дайте им файл .mltbx. Все файлы, которые вы добавили, когда вы группировали тулбокс, включены в файл .mltbx. Когда конечные пользователи установили ваш тулбокс, они не должны быть обеспокоены путем MATLAB или другими деталями установки. Файл .mltbx управляет этими деталями для конечных пользователей.

Для получения информации об установке видят удаление и просмотр информации о тулбоксах, Получают Дополнения и Управляют Вашими Дополнениями.

Можно совместно использовать тулбокс с другими путем присоединения файла .mltbx к электронному письму или использования любого другого метода, который вы обычно используете, чтобы совместно использовать файлы — такие как загрузка на MATLAB Центральный Exchange Файла. Если вы загружаете свой тулбокс на Exchange Файла, ваши пользователи могут загрузить тулбокс из MATLAB. Для получения дополнительной информации смотрите, Получают Дополнения.

Также можно загрузить тулбокс на Exchange Файла, когда вы группируете его. Выберите Package и Share из меню Package наверху диалогового окна Package a Toolbox.

Примечание

В то время как. файлы mltbx могут содержать любые файлы, которые вы задаете, MATLAB, Центральный Exchange Файла помещает дополнительные ограничения на представления. Если ваш тулбокс содержит какое-либо из следующих, он не может быть представлен Exchange Файла:

  • Файлы MEX.

  • Другие бинарные исполняемые файлы, такие как DLLs или средства управления ActiveX®. (Файлы данных и файлы изображений обычно приемлемы.)

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

| | | | |

Похожие темы

Была ли эта тема полезной?