Main Content

创建自定义任务

自定义任务是允许您对一个或多个文件执行一系列操作的 MATLAB® 函数。您可以创建自定义任务函数,然后对工程中的一组选定文件运行自定义任务。例如,您可以创建自定义任务来检查所有代码文件中的错误或运行工程中的所有测试。

创建自定义任务函数

要创建自定义任务函数,请执行以下操作:

  1. 工程选项卡上,点击向下箭头以展开工具库。在工程检查下,点击自定义任务。在“自定义任务”对话框中,点击管理

  2. 点击添加,然后选择使用新函数添加。如果要将现有脚本添加为自定义任务,请选择使用现有函数添加

  3. 指定脚本的文件名,并将新文件保存到 MATLAB 路径上。MATLAB 编辑器将打开包含示例自定义任务函数的新文件。

  4. 编辑该函数以对每个文件执行所需的操作。使用文件顶部的说明来指导您创建具有正确函数签名的自定义任务。自定义任务必须接受文件的完整路径作为单个输入参数,并返回单个输出参数。

    例如,以下自定义任务函数使用 checkcode 函数提取每个文件的代码分析器信息。

    [~,~,ext] = fileparts(file);
    switch ext
        case {'.m', '.mlx', '.mlapp'}
            result = checkcode(file, '-string');
        otherwise
            result = [];
    end

  5. 保存文件。

您可以使用 MATLAB 编辑器来设置断点和调试自定义任务函数,就像对任何其他 MATLAB 函数一样。

运行自定义任务

要对工程中的一组选定文件运行自定义任务,请执行以下操作:

  1. 工程选项卡上,点击向下箭头以展开工具库。在工程检查下,点击自定义任务

  2. 在表的包括列中,选择要对其运行自定义任务的工程文件。

    要在表中一次包括或排除多个文件,请按住 ShiftCtrl 键,选择文件,然后右键点击并选择包括排除。如果自定义任务函数可以识别要对其执行操作的文件,则请包括所有文件。

  3. 自定义任务字段中,从可用的自定义任务函数中进行选择。您也可以直接在字段中输入任务的名称,或者点击浏览

  4. 点击运行任务以运行任务。“自定义任务报告”窗口将显示结果。

  5. 检查表中的结果列,以确保对所有文件正确运行了自定义任务。要查看文件的详细结果信息,请在表中选择该文件。“自定义任务报告”底部的结果窗格将显示详细信息。

保存自定义任务报告

如果您要保存自定义任务结果的记录,或者要与其他人共享结果,则保存自定义任务报告非常有用。

要保存自定义任务报告,请点击“自定义任务报告”底部的发布报告按钮。您可以将报告保存为 HTML 文件或 Microsoft® Word 文件。如果您有 MATLAB Report Generator™,也可以将报告保存为 PDF 文件。

要查看报告文件并将其添加到工程中,请切换到所有文件视图。

相关主题