Main Content

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 将附加功能安装在默认的附加功能安装文件夹中。有关详细信息，包括如何更改默认的附加功能安装文件夹，请参阅获取和管理附加功能。

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) 使用指定的许可证和安装选项安装附加功能。

示例

全部折叠

假定您的 C:\Downloads\ 文件夹中存在 My toolbox.mltbx 工具箱文件，并且该工具箱包含许可协议。通过指明您接受许可协议，即可安装该工具箱并阻止 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"

假设您的系统上安装了名为 My Toolbox 的工具箱的版本 2.0。安装工具箱的版本 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 将安装该附加功能，而不会覆盖以前安装的版本。

输出参量

全部折叠

新附加功能信息，以包含以下列的表形式返回。

字段描述类型
名称附加功能的名称字符串标量
版本附加功能的版本字符串标量
启用是否启用附加功能逻辑值
标识符附加功能的唯一标识符字符串标量

版本历史记录

在 R2018b 中推出

另请参阅

|

主题