matlab.addons.install

Установите дополнение

Описание

пример

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

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

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

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

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

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

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

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

свернуть все

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

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

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