主要内容

创建和共享工具箱

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

创建工具箱

创建工具箱安装文件。

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

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

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

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

    如有必要,请输入工具箱名称。默认情况下,工具箱名称是工具箱文件夹的名称。“工具箱名称”变为.mltbx文件名。

    版本

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

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

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

    工具箱的形象

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

    摘要和说明

    输入工具箱摘要和说明。保持良好的状态是一种良好的做法总结文字简短,并添加细节描述文本。

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

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

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

    默认情况下,如果工具箱包含P-code文件和MATLAB代码文件(.m), MATLAB排除相同文件夹中同名的.m文件从工具箱。要同时包含每分钟.m文件,明确排除MATLAB脚本或函数文件与匹配的p文件选择。

    要从工具箱中排除其他文件或文件夹,请在单击时显示的文本文件中注册它们排除文件和文件夹. 最好排除与工具箱相关的任何源代码管理文件。

    需求

    附加组件-工具箱所需附加组件的列表。在安装工具箱时下载并安装选定的外接程序。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: \ InstalledSoftware \ mysoftware \ '
    这段代码:
    mysoftwarelocation=mytoolbox.getInstallationLocation('mysoftware')
    要在打包工具箱之前在计算机上启用工具箱测试,请单击toolboxname\ getInstallationLocation.mlx链接的底部安装附加软件部分,并输入计算机上每一附加软件的安装位置。

    工具箱可移植性

    MATLAB中使用的信息工具箱可移植性当用户安装工具箱时。如果由于用户的平台或MATLAB版本不受支持而导致兼容性检查失败,MATLAB将显示警告。但是,用户仍然可以安装工具箱。万博1manbetx

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

    支持工具箱的MATLAB版本的发布兼容性列表。万博1manbetx

    s manbetx 845MathWorks产品列表®s manbetx 845您的工具箱所需要的产品。手动创建此列表。

    示例、应用程序和文档

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

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

    • 对于现场脚本(.mlx)例如,将其导出为HTML。上现场编辑选项卡,选择保存>导出到HTML并将其保存在名为超文本标记语言

    • 有关脚本(.m)示例,将其发布到HTML出版功能。发布示例时不要指定输出文件夹。对于要识别示例的工具箱工具包,输出文件夹必须是默认文件夹(超文本标记语言).

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

    应用发布了与工具箱关联的可安装应用。工具箱工具包可以识别应用程序(.mlapp文件)和应用程序安装文件(.mlappinstall文件),并将它们包含在工具箱中。

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

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

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

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

    工具箱的用户可以通过加载项管理器中工具箱的选项菜单查看《入门指南》。有关更多信息,请参阅获取和管理附加组件

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

    或者,您可以生成info.xmlhelptoc.xml模板文件来自Package a Toolbox对话框。要通过帮助浏览器访问文档,请完成文档模板并包含info.xml在MATLAB路径上。

  5. 包你的工具箱。

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

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

    当你创建工具箱时,MATLAB生成一个.prj文件,该文件包含工具箱的信息并经常保存它。最好将其关联起来保存.prj文件,以便您可以快速创建工具箱的未来修订版。

分享工具箱

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

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

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

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

请注意

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

  • MEX文件。

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

另请参阅

|||||

相关的话题