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.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.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