Exponenta Banner
exponenta event banner

matlab.addons.install

Установить надстройку

свернуть все на странице

Синтаксис

newAddon = matlab.addons.install (имя _ файла)
newAddon = matlab.addons.install (имя файла, agreeToLicense)
newAddon = matlab.addons.install (fileName, installOption)
newAddon = matlab.addons.install (имя файла, agreeToLicense, installOption)

Описание

пример

newAddon = matlab.addons.install(fileName) устанавливает надстройку, указанную fileName. Если версия надстройки уже установлена, MATLAB ® перезаписывает предыдущую версию.

MATLAB устанавливает надстройку в папку установки надстройки по умолчанию. Дополнительные сведения, включая изменение папки установки надстроек по умолчанию, см. в разделе Получение надстроек и управление ими.

matlab.addons.install поддерживает только установку панелей инструментов.

пример

newAddon = matlab.addons.install(fileName,agreeToLicense) принимает лицензионное соглашение перед установкой надстройки, если agreeToLicense является true.

пример

newAddon = matlab.addons.install(fileName,installOption) устанавливает надстройку без перезаписи ранее установленных версий, если installOption является 'add'. В противном случае, если версия надстройки уже установлена, MATLAB перезаписывает предыдущую версию.

newAddon = matlab.addons.install(fileName,agreeToLicense,installOption) устанавливает надстройку с использованием указанной лицензии и параметров установки.

Примеры

свернуть все

Предположим, что у вас есть My toolbox.mltbx файл панели инструментов в C:\Downloads\ и что панель инструментов содержит лицензионное соглашение. Установите панель инструментов и не разрешите MATLAB открывать диалоговое окно лицензионного соглашения, указав, что вы принимаете лицензию.

toolboxFile = 'C:\Downloads\My toolbox.mltbx';
agreeToLicense = true;
matlab.addons.toolbox.install(toolboxFile,agreeToLicense)

Убедитесь, что панель инструментов установлена.

addons = matlab.addons.installedAddons
 addons =

  1×4 table

             Name                   Version     Enabled                  Identifier              
    ___________________________    _________    _______    ______________________________________

    "My Toolbox"                   "2.0"         true      "6de8682e-9c3c-407e-bad7-aa103d738d08"

Предположим, что у вас есть версия 2.0 панели инструментов с именем My Toolbox установлен в системе. Установить версию 4.0 панели инструментов без перезаписи версии 2.0.

Предположим, что у вас есть 'My toolbox_v4.0.mltbx' файл панели инструментов в текущей рабочей папке. Установите панель инструментов без перезаписи существующей установленной версии, указав, что требуется добавить панель инструментов.

toolboxFile = 'My toolbox_v4.0.mltbx';
installOption = 'add';
matlab.addons.toolbox.install(toolboxFile, installOption)
ans =

  1×4 table

          Name           Version    Enabled                  Identifier              
    _________________    _______    _______    ______________________________________

    "My toolbox_v4.0"     "4.0"      true      "6de8682e-9c3c-407e-bad7-aa103d738d08"

Если панель инструментов содержит лицензионное соглашение, откроется диалоговое окно с запросом на согласие с лицензией перед установкой.

Убедитесь, что предыдущая версия панели инструментов все еще установлена.

addons = matlab.addons.installedAddons
addons =

  2×4 table

             Name                   Version     Enabled                  Identifier              
    ___________________________    _________    _______    ______________________________________

    "My Toolbox_v4.0"              "4.0"         true      "6de8682e-9c3c-407e-bad7-aa103d738d08"
    "My Toolbox"                   "2.0"         false     "6de8682e-9c3c-407e-bad7-aa103d738d08"

Входные аргументы

свернуть все

Имя устанавливаемого файла, указанное как символьный вектор или строка. Имя файла должно быть допустимым файлом установки панели инструментов (*.mltbx). Можно указать имя файла как абсолютный или относительный путь.

Принять ли лицензионное соглашение, указанное как true или false. По умолчанию agreeToLicense является false.

Если надстройка содержит лицензионное соглашение:

  • Если agreeToLicense является falseзатем MATLAB отображает диалоговое окно, в котором можно принять лицензию или отменить установку.

  • Если agreeToLicense является trueзатем MATLAB устанавливает надстройку без открытия диалогового окна лицензионного соглашения. По настройке agreeToLicense кому true, вы принимаете условия лицензионного соглашения. Перед установкой надстройки проверьте лицензионное соглашение.

Если надстройка не имеет лицензионного соглашения, значение agreeToLicense не влияет на установку.

Перезаписать или добавить надстройку, указанную как 'overwrite' или 'add'. По умолчанию installOption имеет значение 'overwrite'.

Если версия надстройки уже установлена:

  • Если installOption является 'overwrite', то MATLAB перезаписывает все ранее установленные версии надстройки.

  • Если installOption является 'add', то MATLAB устанавливает надстройку без перезаписи ранее установленных версий.

Выходные аргументы

свернуть все

Новая информация о надстройке, возвращенная в виде таблицы с этими столбцами.

ОбластьОписаниеНапечатать
ИмяИмя надстройкиСтроковый скаляр
ВерсияВерсия надстройкиСтроковый скаляр
ПозволенныйВключена ли надстройкаЛогичный
ИдентификаторУникальный идентификатор надстройкиСтроковый скаляр

См. также

|

Темы

Представлен в R2018b

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

Поддержка