matlab.addons.install

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

Синтаксис

newAddon = matlab.addons.install(fileName)
newAddon = matlab.addons.install(fileName,agreeToLicense)
newAddon = matlab.addons.install(fileName,installOption)
newAddon = matlab.addons.install(fileName,agreeToLicense,installOption)

Описание

пример

newAddon = matlab.addons.install(fileName) устанавливает дополнение, заданное fileName. Если версия дополнения уже установлена, 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 устанавливает дополнение, не перезаписывая ранее установленные версии.

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

свернуть все

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

Поле Описание
ИмяИмя дополнения
ВерсияВерсия дополнения
EnabledВключено ли дополнение
ИдентификаторУникальный идентификатор дополнения

Введенный в R2018b