В этом примере показано, как применить пользовательскую задачу к набору файлов, управляемых проектом. Пользовательская задача примера анализирует модели Simulink, которые находятся в проекте, и сообщает о количестве блоков в каждой модели.
1. Создайте и откройте рабочую копию файлов проекта в качестве примера. MATLAB® копирует файлы в папку в качестве примера так, чтобы можно было отредактировать их.
sldemo_slproject_airframe;
Building with 'MinGW64 Compiler (C)'. MEX completed successfully.
2. На вкладке Project кликните по стрелке вниз, чтобы расширить галерею Tools. При Проверках Проекта нажмите Custom Tasks.
Вы описываете пользовательскую задачу с функцией MATLAB®. Проект Корпуса в качестве примера содержит пример пользовательские задачи в custom_tasks папке.
3. Меню задач Custom перечисляет доступные пользовательские задачи.
Чтобы просмотреть, отредактируйте, и создайте пользовательские задачи, на вкладке Project, кликните по стрелке вниз, чтобы расширить галерею Tools. При Проверках Проекта нажмите Custom Tasks. В диалоговом окне Custom Task нажмите Manage.
4. Выберите Analyze Model Files пользовательская задача.
Имя функции вашей выбранной пользовательской задачи появляется в Пользовательском поле задачи. Пример analyzeModelFiles добавляет метку от Метрик категории до каждого файла модели в проекте. Метки в этой категории имеют числовые данные. Пользовательская задача считает количество блоков в каждой модели и присоединяет этот номер к метке.
5. В диалоговом окне Custom Task, во Включать столбце, проверяют, что все флажки файлов модели устанавливаются.
6. Чтобы запустить пользовательскую задачу, нажмите Run Task.
Результаты для выбранного файла показывают в панели Результатов в нижней части диалогового окна. Это может быть полезно, когда возвращенные результаты длинны, или содержат разметку HTML.
Следующий пример показывает диалоговое окно после выполнения пользовательской задачи на некоторых моделях. Можно настроить столбцы, чтобы показать с кнопкой значков винтика
.
Пользовательскими Задачами являются функции MATLAB. Отредактируйте свою пользовательскую задачу с редактором MATLAB. Например, измените пользовательскую задачу программно добавить метку с данными, а также сохранивший любые грязные файлы модели.
7. Запустите следующий код MATLAB, чтобы создать Метрическую категорию и метку Block Count в проекте.
project = currentProject; category = createCategory(project,'Metrics','double');
8. Дважды кликните analyzeModelFiles.m, чтобы отредактировать его в редакторе MATLAB.
9. Добавьте следующие линии сразу после sprintf команды:
[~, compileStats] = sldiagnostics(name,'CompileStats'); addLabel(projectFile, 'Metrics','CPU Compile Time',sum([compileStats.Statistics.CPUTime]));
Можно использовать редактор MATLAB, чтобы установить точки останова и отладить пользовательскую функцию задачи, так же, как с любой другой функцией MATLAB.
Если вы повторно выполняете пользовательскую задачу, она добавляет метку CPU Compile Time в каждый файл модели, который может быть скомпилирован и присоединяет данные к метке, показывающей общее время для всех фаз компиляции для модели. Модели, которые не могут быть скомпилированы, показывают Не пройдено, чтобы анализировать файл в Пользовательском Отчете Задачи и отображение деталей как предупреждение в Командном окне. Исследуйте пользовательскую задачу analyzeModelFiles.m, чтобы видеть, как обработать ошибки.
Чтобы просмотреть новые метрические данные, или покажите Метрический столбец в Пользовательском Отчете Задачи или посмотрите в проекте представление Files.
Создайте новую пользовательскую задачу путем создания новой функции MATLAB. Ваши пользовательские задачи должны:
Будьте сохранены на пути MATLAB.
Примите один входной параметр: полный путь к файлу.
Возвратите один выходной аргумент.
Чтобы создать пользовательские задачи, на вкладке Project, кликают по стрелке вниз, чтобы расширить галерею Tools. При Проверках Проекта нажмите Custom Tasks. В диалоговом окне Custom Task нажмите Manage. В диалоговом окне Manage Custom Tasks нажмите Add, чтобы открыть новый файл с инструкциями, которые ведут вас, чтобы создать пользовательскую задачу с правильной функциональной подписью.
10. Выберите Add> Add Using New Script.
Диалоговое окно файла открывает то, чтобы просить, чтобы вы выбрали, где создать новую пользовательскую задачу. Пользовательская задача должна быть сохранена на пути MATLAB, чтобы запуститься.
11. Обеспечьте имя файла и сохраните файл в custom_tasks папке в рамках проекта.
Редактор MATLAB открывает файл, предварительно заполненный с простым примером пользовательская задача.
12. Чтобы создать вашу новую пользовательскую задачу, отредактируйте содержимое примера, пользовательская задача функционирует и сохраняет.
