Пользовательские задачи MATLAB® функции, которые позволяют вам выполнить ряд операций над одним или несколькими файлами. Можно создать пользовательскую функцию задачи, а затем запустить пользовательскую задачу на выбранном наборе файлов в проекте. Например, можно создать пользовательскую задачу, чтобы проверить все файлы кода на ошибки или запустить все тесты в проекте.
Чтобы создать пользовательскую функцию задачи:
На вкладке Project нажмите Custom Tasks
и выберите
Manage Custom Tasks. Откроется диалоговое окно Управление пользовательскими задачами.
Нажмите Add, а затем выберите Add Using New Function. Если необходимо добавить существующий скрипт в качестве пользовательской задачи, выберите Add Using Existing Function.
Укажите имя файла для скрипта и сохраните новый файл в пути MATLAB. Этот РЕДАКТОР MATLAB открывает новый файл, содержащий пример пользовательской функции задачи.
Отредактируйте функцию, чтобы выполнить необходимое действие над каждым файлом. Используйте инструкции в верхней части файла, чтобы помочь вам создать пользовательскую задачу с правильной подписью функции. Ваши пользовательские задачи должны принять полный путь к файлу в качестве единственного входного параметра и вернуть один выходной аргумент.
Для примера эта пользовательская функция задачи извлекает Анализатор кода информацию для каждого файла, используя checkcode функция.
[~,~,ext] = fileparts(file);
switch ext
case {'.m', '.mlx', '.mlapp'}
result = checkcode(file, '-string');
otherwise
result = [];
endСохраните файл.
Можно использовать редактор MATLAB, чтобы задать точки останова и отладить пользовательскую функцию задачи, так же как и с любой другой функцией MATLAB.
Чтобы запустить пользовательскую задачу на выбранном наборе файлов в вашем проекте:
На вкладке Project щелкните Custom Tasks
и выберите Run Custom Task.
В Include столбце таблицы выберите файлы проекта, на которых необходимо запустить пользовательскую задачу.
Чтобы включить или исключить несколько файлов в таблицу сразу, нажмите клавишу Shift или Ctrl, выберите файлы, а затем щелкните правой кнопкой мыши и выберите Include или Exclude. Если функция пользовательской задачи может идентифицировать файлы, с которыми необходимо работать, включите все файлы.
В поле Custom task выберите из доступных пользовательских функций задачи. Вы также можете ввести имя задачи непосредственно в поле или нажать Browse.
Щелкните Run Task, чтобы запустить задачу. В окне Пользовательский отчет о задаче (Custom Task Report) отображаются результаты.
Проверьте столбец Results в таблице, чтобы убедиться, что пользовательская задача выполнялась правильно во всех файлах. Чтобы просмотреть подробную информацию о результатах для файла, выберите файл в таблице. На панели результатов в нижней части отчета о пользовательских задачах отображаются подробные сведения.
Сохранение пользовательского отчета о задачах полезно, если необходимо сохранить запись результатов пользовательских заданий или если необходимо предоставить общий доступ к результатам другим.
Чтобы сохранить отчет о пользовательских задачах, нажмите кнопку Publish Report в нижней части отчета о пользовательских задачах. Можно сохранить отчет как HTML файла или как Microsoft® Word файла. Если у вас есть MATLAB Report Generator™, вы также можете сохранить отчет как PDF- файл.
Чтобы увидеть файл отчета и добавить его к своему проекту, перейдите к представлению файлов All.