Создание пользовательских задач

Пользовательские задачи MATLAB® функции, которые позволяют вам выполнить ряд операций над одним или несколькими файлами. Можно создать пользовательскую функцию задачи, а затем запустить пользовательскую задачу на выбранном наборе файлов в проекте. Например, можно создать пользовательскую задачу, чтобы проверить все файлы кода на ошибки или запустить все тесты в проекте.

Создайте пользовательскую функцию задачи

Чтобы создать пользовательскую функцию задачи:

  1. На вкладке Project нажмите Custom Tasks и выберите Manage Custom Tasks. Откроется диалоговое окно Управление пользовательскими задачами.

  2. Нажмите Add, а затем выберите Add Using New Function. Если необходимо добавить существующий скрипт в качестве пользовательской задачи, выберите Add Using Existing Function.

  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. На вкладке Project щелкните Custom Tasks и выберите Run Custom Task.

  2. В Include столбце таблицы выберите файлы проекта, на которых необходимо запустить пользовательскую задачу.

    Чтобы включить или исключить несколько файлов в таблицу сразу, нажмите клавишу Shift или Ctrl, выберите файлы, а затем щелкните правой кнопкой мыши и выберите Include или Exclude. Если функция пользовательской задачи может идентифицировать файлы, с которыми необходимо работать, включите все файлы.

  3. В поле Custom task выберите из доступных пользовательских функций задачи. Вы также можете ввести имя задачи непосредственно в поле или нажать Browse.

  4. Щелкните Run Task, чтобы запустить задачу. В окне Пользовательский отчет о задаче (Custom Task Report) отображаются результаты.

  5. Проверьте столбец Results в таблице, чтобы убедиться, что пользовательская задача выполнялась правильно во всех файлах. Чтобы просмотреть подробную информацию о результатах для файла, выберите файл в таблице. На панели результатов в нижней части отчета о пользовательских задачах отображаются подробные сведения.

Сохранение отчета о пользовательских задачах

Сохранение пользовательского отчета о задачах полезно, если необходимо сохранить запись результатов пользовательских заданий или если необходимо предоставить общий доступ к результатам другим.

Чтобы сохранить отчет о пользовательских задачах, нажмите кнопку Publish Report в нижней части отчета о пользовательских задачах. Можно сохранить отчет как HTML файла или как Microsoft® Word файла. Если у вас есть MATLAB Report Generator™, вы также можете сохранить отчет как PDF- файл.

Чтобы увидеть файл отчета и добавить его к своему проекту, перейдите к представлению файлов All.

Похожие темы

Для просмотра документации необходимо авторизоваться на сайте