主要内容

创建和共享工具箱

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

创建工具箱

创建工具箱安装文件。

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

  2. 在“Package a Toolbox”对话框中,单击按钮并选择工具箱文件夹。从工具箱文件夹上方的文件夹级别创建工具箱包是一种很好的做法。这个.mltbx工具箱文件包含有关工具箱文件和文件夹的路径设置的信息。默认情况下,创建工具箱时所在路径上包含的任何文件夹和文件在最终用户安装工具箱后都会显示在它们的路径上。

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

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

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

    版本

    中输入工具箱版本号专业少数的错误建造格式。错误建造是可选的。

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

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

    工具箱映像

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

    总结和描述

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

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

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

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

    默认情况下,如果工具箱包含P-code文件和MATLAB代码文件(.m), MATLAB排除相同文件夹中同名的.m工具箱中的文件。包括每分钟.m文件,清除排除具有匹配P文件的MATLAB脚本或函数文件选项

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

    要求

    加载项-工具箱所需的加载项列表。安装工具箱时,将下载并安装选定的加载项。MATLAB自动使用它认为工具箱需要的附加组件填充此列表,并默认选择所有附加组件。您可以选择省略任何不希望随工具箱一起安装的附加组件。

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

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

    安装操作

    MATLAB Path-用户安装工具箱时添加到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显示一个警告。金宝app但是,用户仍然可以安装工具箱。

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

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

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

    示例、应用程序和文档

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

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

    • 对于现场脚本(.mlx)示例,将其导出为HTML。在住编辑器选项卡上,选择拯救>导出为HTML并将其保存在一个名为html

    • 剧本(.m)示例,将其发布到HTML发布函数。发布示例时不要指定输出文件夹。要让Package a Toolbox工具识别示例,输出文件夹必须是默认文件夹(html).

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

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

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

    • 全部的.mlappinstall工具箱文件夹中的文件将在用户的MATLAB应用程序库中安装和注册。

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

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

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

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

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

  5. 包你的工具箱。

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

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

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

共享工具箱

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

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

您可以与他人分享您的工具箱通过附加.mltbx文件到电子邮件消息,或使用任何其他通常用于共享文件的方法,如上载到MATLAB Central文件交换. 如果将工具箱上载到文件交换,用户可以从MATLAB中下载工具箱。有关详细信息,请参阅获取和管理附加组件

或者,您可以在打包工具箱时将其上载到文件交换。挑选包和分享菜单,在“包工具箱”对话框的顶部。

请注意

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

  • mex files。

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

另请参阅

|||||

相关话题