В этом примере показано, как применить пользовательскую задачу к набору файлов, управляемых проектом. Пример пользовательской задачи анализирует модели Simulink, которые находятся в проекте, сообщая количество блоков в каждой модели.
1. Выполните следующие команды для создания и открытия рабочей копии примера «sldemo_slproject_airframe».
sldemo_slproject_airframe;
Building with 'MinGW64 Compiler (C)'. MEX completed successfully.
Пример проекта копирует файлы в новую папку, чтобы их можно было редактировать и помещать под локальный контроль версий.
2. Нажмите кнопку «Пользовательская задача» в разделе «Сервис» вкладки «Панель инструментов проекта».
Пользовательская задача определяется с помощью функции MATLAB ®. Пример проекта Планер содержит примеры пользовательских задач в папке custom_tasks.
3. В меню «Пользовательская задача» перечислены доступные пользовательские задачи.
Для просмотра, редактирования и создания пользовательских задач выберите «Пользовательские задачи» > «Управление пользовательскими задачами» в разделе «Сервис» вкладки «Панель инструментов проекта».
4. Выберите пользовательскую задачу «Анализ файлов модели».
Имя функции выбранной пользовательской задачи появится в поле редактирования «Пользовательская задача». Пример анализа ModelFiles добавляет метку из категории «Метрика» к каждому файлу модели в проекте. Метки этой категории имеют числовые данные. Пользовательская задача подсчитывает количество блоков в каждой модели и прикрепляет это число к метке.
5. В диалоговом окне Пользовательская задача (Custom Task) убедитесь, что во всех файлах модели установлены флажки в столбце Включить (Include).
6. Нажмите кнопку Run Task в правом нижнем углу диалогового окна Custom Task.
Результаты для выбранного файла также отображаются на панели Результаты (Results) в нижней части диалогового окна. Это может быть полезно, если возвращенные результаты являются длинными или содержат разметку HTML.
В следующем примере показано диалоговое окно после выполнения пользовательской задачи в некоторых моделях. Можно настроить столбцы так, чтобы они отображались с помощью значка «cog» Кнопка действий в правом верхнем углу.
Пользовательские задачи - это функции MATLAB. Отредактируйте пользовательскую задачу с помощью редактора MATLAB. В следующих шагах пользовательская задача изменяется, чтобы использовать API проекта для добавления метки с данными, а также сохранения любых грязных файлов модели.
7. Выполните следующий код MATLAB для создания категории «Метрики» и метки «Количество блоков» в проекте.
project = currentProject; category = createCategory(project, 'Metrics', 'double');
8. Дважды щелкните Анализ (Analysis) Модель (Model) Файлы (Files) .m (или щелкните правой кнопкой мыши и выберите Открыть (Open)), чтобы править его в редакторе MATLAB.
9. Непосредственно после команды sprintf добавьте следующие строки:
[~, compileStats] = sldiagnostics(name, 'CompileStats'); addLabel(projectFile, 'Metrics', 'CPU Compile Time', sum([compileStats.Statistics.CPUTime]));
Редактор MATLAB можно использовать для установки точек останова и отладки пользовательской функции задачи, как и для любой другой функции MATLAB.
При повторном запуске пользовательской задачи к каждому файлу модели, который можно скомпилировать, добавляется метка «Время компиляции ЦП», а к метке добавляются данные, показывающие общее время для всех этапов компиляции модели. Модели, которые не могут быть скомпилированы, отображаются как «Failed to analysis file» в отчете о настраиваемых задачах, а подробности отображаются как предупреждение в окне команд. Проверьте пользовательскую задачу AnalyzModelFiles.m, чтобы узнать, как обрабатывать ошибки.
Чтобы просмотреть новые данные метрик, либо отобразите столбец «Метрики» в отчете о настраиваемых задачах, либо посмотрите в представлении файлов проекта.
Создайте новую пользовательскую задачу, создав новую функцию MATLAB. Настраиваемые задачи должны:
Сохранить в пути MATLAB.
Принять один входной аргумент: полный путь к файлу.
Возвращает один выходной аргумент.
Для создания пользовательских задач выберите «Пользовательские задачи» > «Управление пользовательскими задачами» в разделе «Сервис» вкладки панели инструментов проекта. В диалоговом окне Управление пользовательскими задачами нажмите кнопку Добавить, чтобы открыть новый файл с инструкциями, которые помогут создать пользовательскую задачу с правильной подписью функции.
10. Нажмите «Добавить» и выберите пункт меню «Добавить с помощью нового сценария».
Откроется диалоговое окно с запросом на выбор места создания новой пользовательской задачи. Пользовательская задача должна быть сохранена в пути MATLAB для выполнения.
11. Укажите имя файла и сохраните его в папке custom _ tasks проекта.
Редактор MATLAB открывает файл, предварительно заполненный простым примером пользовательской задачи.
12. Чтобы создать новую пользовательскую задачу, отредактируйте содержимое примера пользовательской функции задачи и сохраните его.