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

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

Создание панели инструментов

Чтобы создать установочный файл панели инструментов, выполните следующие действия.

В разделе Среда вкладки Главная (Home) выберите Панель инструментов пакета (Package Toolbox) в меню Надстройки (Add-On).
В диалоговом окне «Упаковка панели инструментов» нажмите кнопку и выберите папку панели инструментов. Рекомендуется создавать пакет панели инструментов на уровне папки над папкой панели инструментов. .mltbx содержит информацию о параметрах пути для файлов и папок панели инструментов. По умолчанию все включенные папки и файлы, которые находятся на вашем пути при создании панели инструментов, отображаются на их путях после того, как конечные пользователи установят панель инструментов.

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

Информационное поле панели инструментов	Описание
Имя панели инструментов	При необходимости введите имя панели инструментов. По умолчанию имя панели инструментов является именем папки панели инструментов. Имя панели инструментов становится именем `.mltbx` имя файла.
Версия	Введите номер версии панели инструментов в поле `Major`.`Minor`.`Bug`.`Build` формат. `Bug` и `Build` являются необязательными.
Имя автора, адрес электронной почты и компания	Введите контактную информацию для автора панели инструментов. Чтобы сохранить контактную информацию, щелкните Задать как контакт по умолчанию.
Изображение панели инструментов	Чтобы выбрать изображение, представляющее панель инструментов, щелкните Выбрать изображение панели инструментов.
Сводка и описание	Введите сводку и описание панели инструментов. Рекомендуется сохранять краткий текст сводки и добавлять подробности в текст описания.

Чтобы убедиться, что MATLAB обнаруживает ожидаемые компоненты, просмотрите содержимое панели инструментов. После выбора папки панели инструментов появятся следующие разделы диалогового окна «Упаковка панели инструментов».

Упаковка раздела диалогового окна «Панель инструментов»	Описание
Файлы и папки панели инструментов	Список папок и файлов, содержащихся в панели инструментов. Перечисленные файлы и папки - это только те файлы, которые находятся на верхнем уровне папки панели инструментов. Невозможно перемещаться по папкам в диалоговом окне «Упаковка панели инструментов». По умолчанию, если панель инструментов содержит файл P-кода и файл кода MATLAB (`.m`) с тем же именем в той же папке, MATLAB исключает `.m` файл с панели инструментов. Чтобы включить оба `.p` и `.m` снимите флажок «Исключить скрипт MATLAB или файлы функций с соответствующими P-файлами». Чтобы исключить другие файлы или папки из панели инструментов, зарегистрируйте их в текстовом файле, который отображается при нажатии кнопки «Исключить файлы и папки». Рекомендуется исключить все файлы системы управления версиями, связанные с панелью инструментов.
Требования	Надстройки - список надстроек, необходимых для панели инструментов. Выбранные надстройки загружаются и устанавливаются при установке панели инструментов. MATLAB автоматически заполняет этот список надстройками, которые, по его мнению, требуются панели инструментов, и выбирает их все по умолчанию. Можно опустить любые надстройки, которые не требуется устанавливать с помощью панели инструментов. Если MATLAB не может найти информацию об установке надстройки в списке, необходимо ввести URL загрузки. URL загрузки - это место, где MATLAB может загрузить и установить надстройку. Когда панель инструментов установлена, MATLAB устанавливает надстройку по указанному URL-адресу.
Требования	Внешние файлы - список файлов, необходимых для панели инструментов, которые находятся вне папки панели инструментов. MATLAB автоматически заполняет этот список файлами, которые, по его мнению, требуются панели инструментов, и выбирает их все по умолчанию. Можно опустить любые ненужные файлы на панели инструментов.
Действия по установке	Путь MATLAB - список папок, добавляемых к пути MATLAB пользователя при установке панели инструментов. По умолчанию список включает любую папку панели инструментов, которая находится на вашем пути при создании панели инструментов. Можно исключить папки из добавления к пути пользователя, удалив их из списка. Для управления путем при установке панели инструментов щелкните Управление текущим путем MATLAB. Чтобы восстановить список по умолчанию, нажмите кнопку «Восстановить текущий путь MATLAB».
	Путь к классам Java - список файлов Java ®, добавляемых к пути к классам Java пользователя при установке панели инструментов. После установки панели инструментов файлы JAR добавляются в динамический путь в течение сеанса MATLAB. Когда пользователь панели инструментов перезапускает MATLAB, файлы JAR добавляются к статическому пути.
	Установка дополнительного программного обеспечения - список ZIP-файлов дополнительного программного обеспечения, которые устанавливаются в системе пользователя при установке панели инструментов. Укажите следующие поля: Отображаемое имя - имя, отображаемое пользователю при установке панели инструментов. URL лицензии - URL соглашения о дополнительном программном обеспечении, отображаемого пользователю при установке панели инструментов. Пользователю предлагается просмотреть лицензионное соглашение и принять его во время установки. Необходимо указать действительный URL-адрес лицензионного соглашения. URL загрузки - URL-адрес ZIP-файла, содержащего дополнительное программное обеспечение. Чтобы указать различные 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` папка. Кроме того, можно вручную опубликовать файлы кода в формате HTML в MATLAB, а затем включить файлы кода и файлы HTML в папку панели инструментов. Для сценария в реальном времени (`.mlx`), например, экспортировать его в HTML. На вкладке «Интерактивный редактор» выберите «Сохранить» > «Экспортировать в HTML» и сохраните его в папке с именем `html`. Для сценария (`.m`) например, опубликовать его в HTML с помощью `publish` функция. Не указывайте папку вывода при публикации примеров. Чтобы инструмент Package a Toolbox распознал примеры, папка вывода должна быть папкой по умолчанию (`html`). Чтобы создать различные категории для примеров, поместите примеры в различные подпапки в папке панели инструментов. При добавлении папки панели инструментов в диалоговое окно «Упаковка панели инструментов» MATLAB создает `demos.xml` файл для описания примеров и принимает имя вложенной папки примера в качестве имени категории примеров. Кроме того, можно создать собственный `demos.xml` файл. `demos.xml` позволяет получателям получить доступ к вашим примерам через ссылку Дополнительное программное обеспечение в нижней части главной страницы браузера справки. Дополнительные сведения см. в разделе Отображение пользовательских примеров.
	Приложения - опубликованные установочные приложения MATLAB, связанные с вашей панелью инструментов. Инструмент Package a Toolbox распознает приложения (`.mlapp` файлы) и файлы установщика приложения (`.mlappinstall` файлы) и включает их в панель инструментов. Чтобы указать, какие приложения (`.mlapp` файлы) также устанавливаются и регистрируются в галерее приложений MATLAB, выберите приложения. Все `.mlappinstall` файлы в папке панели инструментов устанавливаются и регистрируются в галерее приложений MATLAB.
	Руководство по началу работы - краткое руководство для панели инструментов. Чтобы инструмент Package a Toolbox распознал руководство по началу работы, включите руководство в качестве реального сценария с именем`GettingStarted.mlx` в `doc` в папке панели инструментов. Кроме того, можно создавать и редактировать `GettingStarted.mlx` в диалоговом окне «Упаковка» «Панель инструментов». Пользователи панели инструментов могут просматривать руководство по началу работы в меню «Параметры» панели инструментов в диспетчере надстроек. Дополнительные сведения см. в разделе Получение надстроек и управление ими.
	Интеграция с обозревателем справки - пользовательская документация, связанная с панелью инструментов. Чтобы инструмент «Набор инструментов» распознавал пользовательскую документацию, включите `info.xml` для идентификации файлов документации. Если вы используете `builddocsearchdb` для создания базы данных документации перед упаковкой панели инструментов можно включить сгенерированную `helpsearch` вложенная папка на панели инструментов. `info.xml` файл и `helpsearch` папка позволяет получателям получить доступ к документации через ссылку Дополнительное программное обеспечение в нижней части главной страницы браузера справки. Дополнительные сведения см. в разделе Отображение пользовательской документации. Кроме того, можно создать `info.xml` и `helptoc.xml` файлы шаблонов из диалогового окна «Упаковка панели инструментов». Чтобы получить доступ к документации через браузер справки, заполните шаблоны документации и включите `info.xml` на пути MATLAB.

Упакуйте панель инструментов.
- Чтобы сохранить панель инструментов, щелкните Пакет (Package) в верхней части диалогового окна Пакет (Package) Панель инструментов (Toolbox). Упаковка панели инструментов создает .mltbx в текущей папке MATLAB.
- Чтобы сохранить панель инструментов и поделиться ею в MATLAB Central File Exchange, выберите «Пакет» и «Общий доступ» в меню «Пакет» в верхней части диалогового окна «Пакет». Эта опция создает .mltbx файл в текущей папке MATLAB и открывает веб-страницу для отправки панели инструментов в File Exchange. MATLAB заполняет форму отправки обмена файлами информацией о панели инструментов. Просмотрите и отправьте форму для совместного использования панели инструментов на файловом сервере Exchange.
При создании панели инструментов MATLAB создает .prj файл, содержащий информацию о панели инструментов и часто сохраняющий ее. Рекомендуется сохранить это связанное .prj для быстрого создания будущих редакций панели инструментов.

Общий доступ к панели инструментов

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

Сведения об установке, удалении и просмотре панелей инструментов см. в разделе Получение надстроек и управление ими.

Вы можете поделиться своей панелью инструментов с другими пользователями, подключив .mltbx файл в сообщение электронной почты или с помощью любого другого метода, который обычно используется для совместного использования файлов, например, при отправке в MATLAB Central File Exchange. При загрузке панели инструментов в File Exchange пользователи могут загрузить ее из MATLAB. Дополнительные сведения см. в разделе Получение надстроек и управление ими.

Можно также загрузить панель инструментов в File Exchange при ее упаковке. Выберите пункт Пакет и общий доступ (Package and Share) в меню Пакет (Package) в верхней части диалогового окна Пакет (Package) Панель инструментов (Toolbox).

Примечание

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

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

См. также

Документация