Main Content

matlab.addons.toolbox.installToolbox

安装工具箱文件

说明

示例

installedToolbox = matlab.addons.toolbox.installToolbox(toolboxFile) 安装由 toolboxFile 指定的工具箱文件(.mltbx 文件),并返回有关该工具箱的信息。

MATLAB® 将工具箱安装在默认的附加功能安装文件夹中。有关详细信息,包括如何更改默认的附加功能安装文件夹,请参阅获取和管理附加功能

示例

如果 agreeToLicensetrueinstalledToolbox = matlab.addons.toolbox.installToolbox(toolboxFile,agreeToLicense) 将在安装工具箱之前接受许可协议。

示例

全部折叠

假定您的当前工作文件夹中存在 myToolbox.mltbx 工具箱文件。安装工具箱。

toolboxFile = 'MyToolbox.mltbx';
installedToolbox = matlab.addons.toolbox.installToolbox(toolboxFile)
installedToolbox = 

       Name: 'myToolbox'
    Version: '2.0'
       Guid: 'd0169b4a-fe74-463f-981a-26160c94cbe5'

如果工具箱包含许可协议,会打开一个对话框,提示您需要在安装之前接受许可协议。

假定您的 C:\Downloads\ 文件夹中存在 myToolbox.mltbx 工具箱文件,并且该工具箱包含许可协议。通过指明您接受许可协议,即可安装该工具箱并阻止 MATLAB 打开许可协议对话框。

toolboxFile = 'C:\Downloads\MyToolbox.mltbx';
agreeToLicense = true;
installedToolbox = matlab.addons.toolbox.installToolbox(toolboxFile,agreeToLicense)
installedToolbox = 

       Name: 'myToolbox'
    Version: '2.0'
       Guid: 'd0169b4a-fe74-463f-981a-26160c94cbe5'

输入参数

全部折叠

工具箱文件(.mltbx 文件)的名称,指定为字符向量或字符串标量。名称中包括文件的相对或绝对路径。

示例: toolboxFile = 'myToolbox.mltbx'

示例: toolboxFile = "C:\Work\myOtherToolbox.mltbx"

表示接受许可协议的指示符,指定为 falsetrue。默认情况下,agreeToLicensefalse。如果工具箱包含许可协议:

  • 如果 agreeToLicensefalse,MATLAB 将显示一个对话框,您可以在其中接受许可协议或取消安装。

  • 如果 agreeToLicensetrue,MATLAB 将安装工具箱,而不打开许可协议对话框。通过将 agreeToLicense 设置为 true,即表示您接受许可协议的条款。请务必在安装工具箱之前仔细阅读许可协议的内容。

如果工具箱不包含许可协议,则 agreeToLicense 的值对安装没有影响。

数据类型: logical

输出参数

全部折叠

有关安装的工具箱的信息,以结构体形式返回。该结构体包含以下字段。

字段描述
Name工具箱的名称
Version工具箱的版本
Guid唯一的工具箱标识符

备选方法

您可以从“附加功能资源管理器”用户界面安装工具箱。有关详细信息,请参阅获取和管理附加功能

版本历史记录

在 R2016a 中推出