主要内容

创建和共享工具箱

你可以打包MATLAB®文件来创建一个工具箱以与他人共享。这些文件可以包括MATLAB代码、数据、应用程序、示例和文档。创建工具箱时,MATLAB生成一个安装文件(.mltbx),使您或其他人能够安装您的工具箱。

创建工具箱

创建工具箱安装文件:

  1. 环境部份首页选项卡上,选择包的工具箱附加组件菜单。

  2. 在“打包工具箱”对话框中,单击按钮并选择工具箱文件夹。从工具箱文件夹上面的文件夹级别创建工具箱包是一个很好的实践。的.mltbx工具箱文件包含有关工具箱文件和文件夹的路径设置的信息。默认情况下,在创建工具箱时位于路径上的所包含的任何文件夹和文件在最终用户安装工具箱后将显示在其路径上。

  3. 在对话框中,添加关于工具箱的以下信息。

    工具箱信息字段 描述
    工具箱的名字

    如果需要,请输入工具箱名称。默认情况下,工具箱名称是工具箱文件夹的名称。工具箱名称变成.mltbx文件名。

    版本

    中输入工具箱版本号主要错误构建格式。错误而且构建是可选的。

    作者姓名,电子邮件和公司

    输入工具箱作者的联系信息。单击,保存联系人信息设置为默认联系人

    工具箱的形象

    若要选择代表工具箱的图像,请单击选择工具箱图像

    摘要及描述

    输入工具箱摘要和描述。这是一个很好的习惯总结文本简要并添加细节描述文本。

  4. 为了确保MATLAB检测到预期的组件,请检查工具箱内容。选择工具箱文件夹后,将出现“打包工具箱”对话框的以下部分。

    打包工具箱对话框部分 描述
    工具箱文件和文件夹

    工具箱中包含的文件夹和文件的列表。列出的文件和文件夹只是位于工具箱文件夹顶层的那些文件。无法在“工具箱打包”对话框中的文件夹中导航。

    默认情况下,如果工具箱包含P-code文件和MATLAB代码文件(.m)在同一文件夹中使用相同的名称,MATLAB排除.m工具箱中的文件。要同时包括每分钟而且.m文件,清除排除匹配p文件的MATLAB脚本或函数文件选择。

    若要排除工具箱中的其他文件或文件夹,请在单击时显示的文本文件中注册它们排除文件和文件夹.排除与工具箱相关的任何源代码控制文件是一个很好的实践。

    需求

    附加组件-工具箱所需的附加组件列表。安装工具箱时下载并安装选定的外接程序。MATLAB用它认为工具箱需要的附加组件自动填充此列表,并默认选择所有附加组件。您可以选择省略不想与工具箱一起安装的任何附加组件。

    如果MATLAB无法在列表中找到加载项的安装信息,则必须输入下载URL。下载URL是MATLAB可以下载和安装加载项的位置。工具箱安装后,MATLAB使用指定的URL安装加载项。

    外部文件-工具箱所需的文件列表,这些文件位于工具箱文件夹之外。MATLAB用它认为工具箱需要的文件自动填充这个列表,并默认选择它们。您可以选择省略工具箱中不需要的任何文件。

    安装操作

    MATLAB路径-当用户安装工具箱时添加到用户MATLAB路径的文件夹列表。默认情况下,该列表包括创建工具箱时路径上的任何工具箱文件夹。通过将文件夹从列表中清除,可以将它们排除在用户路径中。若要管理工具箱安装时的路径,请单击管理当前MATLAB路径.单击,将列表恢复为默认列表重置到当前MATLAB路径

    Java类路径- Java列表®当用户安装工具箱时添加到用户Java类路径的文件。在工具箱安装之后,JAR文件在MATLAB会话期间被添加到动态路径中。当工具箱用户重新启动MATLAB时,JAR文件被添加到静态路径中。

    附加软件的安装-当用户安装工具箱时安装在用户系统上的附加软件ZIP文件的列表。

    指定这些字段:

    • 显示名称-当用户安装工具箱时显示给他们的名称。

    • 许可证的URL-在用户安装工具箱时显示给用户的附加软件许可协议的URL。在安装期间,系统提示用户审查并同意许可协议。必须为许可协议指定有效的URL。

    • 下载网址-包含附加软件的ZIP文件的URL。如果要为不同的平台指定不同的下载URL,请在下载URL前的下拉菜单中选择平台名称。然后,单击添加平台为其他平台添加下载URL。

    当用户安装工具箱时,MATLAB将在工具箱中安装所有附加软件插件\工具箱\ AdditionalSoftware文件夹,插件加载项的默认安装文件夹。有关外接程序默认安装文件夹位置的详细信息,请参见获取和管理外接组件

    如果工具箱中包含引用指定附加软件的安装文件夹的代码,请使这些引用可移植到其他计算机。将引用替换为对生成函数的调用toolboxname\ getInstallationLocation.mlx,在那里toolboxname是工具箱的名称。例如,如果您正在创建一个名为mytoolbox并希望引用附加软件的安装位置mysoftware,替换此代码

    mysoftwarelocation = 'C:\ installdsoftware \mysoftware\'
    下面的代码:
    mysoftwarelocation = mytoolbox.getInstallationLocation('mysoftware')
    要在打包工具箱之前在计算机上启用工具箱测试,请单击toolboxname\ getInstallationLocation.mlx链接的底部安装附加软件节,并输入计算机上每个附加软件的安装位置。

    工具箱可移植性

    MATLAB中使用的信息工具箱可移植性部分在用户安装工具箱时。如果兼容性检查失败是因为用户拥有不受支持的平台或MATLAB版本,MATLAB将显示警告。金宝app但是,用户仍然可以安装工具箱。

    平台兼容性——支持工具箱的平台列表。金宝app考虑您的工具箱是否有特定于平台的第三方软件或硬件需求。MATLAB在线™不能与硬件交互,包括用于图像采集和仪器控制的设备。

    版本兼容性—支持工具箱的MATLAB版本列表。金宝app

    下载188bet金宝搏MathWorks的产品列表®下载188bet金宝搏工具箱所需的产品。手动创建此列表。

    示例、应用程序和文档

    示例-与工具箱相关的MATLAB示例。包括.m而且.mlx文件作为示例,单击添加示例按钮,选择您的代码文件,然后单击发布HTML.MATLAB将代码发布到HTML中,并将输出文件放在超文本标记语言文件夹中。

    或者,您可以在MATLAB中手动将代码文件发布到HTML中,然后将代码文件和HTML文件包含在工具箱文件夹中。

    • 对于实时脚本(.mlx)的例子,导出到HTML。在住编辑器选项卡上,选择保存>导出到HTML并保存在一个名为超文本标记语言

    • 对于脚本(.m)示例,将其发布到HTML中发布函数。发布示例时不要指定输出文件夹。为使“工具箱工具箱”工具能够识别示例,输出文件夹必须为默认文件夹(超文本标记语言).

    要为示例创建不同的类别,请将示例放在工具箱文件夹中的不同子文件夹中。将工具箱文件夹添加到“打包工具箱”对话框时,MATLAB将创建一个demos.xml文件来描述示例,并将示例子文件夹名称作为示例类别名称。或者,您也可以创建自己的demos.xml文件。的demos.xml文件允许收件人通过补充软件链接在帮助浏览器主页底部。有关更多信息,请参见显示自定义示例

    应用程序-发布的MATLAB安装应用程序与您的工具箱相关联。工具包工具识别应用程序(.mlapp文件)和应用程序安装文件(.mlappinstall文件),并将它们包括在工具箱中。

    • 要指定哪些应用程序(.mlapp文件)也安装和注册在用户的MATLAB应用程序库,选择应用程序。

    • 所有.mlappinstall工具箱文件夹中的文件被安装并注册到用户的MATLAB应用程序库中。

    入门指南-工具箱的快速入门指南。若要“工具包工具箱”工具识别入门指南,请将该指南作为名为GettingStarted.mlx在一个医生工具箱文件夹中的子文件夹。

    或者,您也可以生成和编辑GettingStarted.mlx从“打包工具箱”对话框。

    工具箱的用户可以通过外接程序管理器中工具箱的“选项”菜单查看“入门指南”。有关更多信息,请参见获取和管理外接组件

    帮助浏览器集成—与工具箱相关联的自定义文档。对于“包”工具箱工具以识别自定义文档,请包含info.xml文件来标识您的文档文件。如果你使用builddocsearchdb函数在打包工具箱之前构建文档数据库,则可以包含生成的helpsearch工具箱中的子文件夹。的info.xml文件和helpsearch文件夹允许收件人通过补充软件链接在帮助浏览器主页底部。有关更多信息,请参见显示自定义文档

    或者,您可以生成info.xml而且helptoc.xml“打包工具箱”对话框中的模板文件。若要通过“帮助”浏览器访问文档,请完成文档模板并包含info.xml在MATLAB路径上。

  5. 打包你的工具箱。

    • 若要保存工具箱,请单击在“打包工具箱”对话框的顶部。打包工具箱会生成一个.mltbx文件在您当前的MATLAB文件夹。

    • 保存工具箱并在MATLAB Central上共享文件交换中,选择打包和共享“打包工具箱”对话框顶部的菜单。此选项生成.mltbx文件在您当前的MATLAB文件夹中,并打开一个web页面,以便将工具箱提交到文件交换。MATLAB用工具箱的信息填充File Exchange提交表单。检查并提交表单以在File Exchange上共享您的工具箱。

    创建工具箱时,MATLAB生成一个.prj文件,该文件包含有关工具箱的信息,并经常保存它。保存相关的文件是一种很好的做法.prj文件,以便您可以快速创建工具箱的未来修订版。

分享工具箱

与他人分享你的工具箱,给他们.mltbx文件。打包工具箱时添加的所有文件都包含在.mltbx文件。当最终用户安装工具箱时,他们不需要关心MATLAB路径或其他安装细节。的.mltbxFile为最终用户管理这些详细信息。

有关安装、卸载和查看工具箱信息的信息,请参见获取和管理外接组件

控件,您可以与其他人共享工具箱.mltbx文件到电子邮件消息中,或使用通常用于共享文件的任何其他方法—例如上传到MATLAB Central文件交换.如果您将工具箱上传到File Exchange,您的用户可以从MATLAB中下载工具箱。有关更多信息,请参见获取和管理外接组件

或者,您可以在打包工具箱时将工具箱上传到File Exchange。选择打包和共享“打包工具箱”对话框顶部的菜单。

请注意

.mltbx文件可以包含您指定的任何文件,MATLAB中央文件交换对提交进行了额外的限制。如果您的工具箱包含以下任何一项,则无法提交到文件交换:

  • mex files。

  • 其他二进制可执行文件,如dll或ActiveX®控制。(数据和图像文件通常是可以接受的。)

另请参阅

|||||

相关的话题