В этом примере показано, как использовать проект для управления файлами в проекте. Начиная с существующего проекта, который уже сдан на хранение в систему управления версиями, в этом примере показано, как просматривать измененные файлы, сравнивать версии файлов и анализировать зависимости проекта.
Создайте и откройте рабочую копию файлов примеров проекта. MATLAB ® копирует файлы в папку примера, чтобы их можно было редактировать. Пример проекта находится под управлением версии Subversion (SVN).
sldemo_slproject_airframe_svn
Building with 'MinGW64 Compiler (C)'. MEX completed successfully.
ans =
Project with properties:
Name: "Airframe Example"
SourceControlIntegration: "SVN (1.9)"
RepositoryLocation: "file:///C:/workSpace/examples/repositories/airframe6/trunk"
SourceControlMessages: [1×0 string]
ReadOnly: 0
TopLevel: 1
Dependencies: [1×1 digraph]
Categories: [1×1 matlab.project.Category]
Files: [1×30 matlab.project.ProjectFile]
Shortcuts: [1×7 matlab.project.Shortcut]
ProjectPath: [1×7 matlab.project.PathFolder]
ProjectReferences: [1×0 matlab.project.ProjectReference]
StartupFiles: [1×0 string]
ShutdownFiles: [1×0 string]
DefinitionFilesType: FixedPathMultiFile
Description: "This is an example project.↵↵Use the "Project Shortcuts" toolstrip tab to find ways of getting started with this project."
RootFolder: "C:\workSpace\examples\airframe6"
SimulinkCacheFolder: "C:\workSpace\examples\airframe6\work\cache"
ProjectStartupFolder: "C:\workSpace\examples\airframe6"
SimulinkCodeGenFolder: "C:\workSpace\examples\airframe6\work\codegen"
При открытии проекта MATLAB добавляет путь проекта к пути поиска MATLAB перед применением ярлыков запуска.
При закрытии проекта MATLAB удаляет путь проекта из пути поиска MATLAB после применения ярлыков завершения работы.
1. Чтобы добавить или удалить папки в путь к проекту, на вкладке "Проект" в разделе "Среда" выберите "Путь к проекту:
Чтобы добавить папку (без вложенных папок) в путь проекта, нажмите кнопку «Добавить папку». Если требуется добавить папку и вложенные папки, нажмите кнопку Добавить с вложенными папками. Затем с помощью диалогового окна «Открыть» добавьте новую папку.
Чтобы удалить папку из пути проекта, выберите папку из списка отображения. Затем нажмите кнопку Удалить.
Важно добавить файлы проекта в путь к проекту, чтобы анализатор зависимостей обнаружил все файлы проекта.
2. На вкладке Проект (Project) в разделе Среда (Environment) щелкните Подробности (Details). Диалоговое окно «Сведения о проекте» используется для:
Измените имя проекта или добавьте описание.
Просмотр корневой папки Project. Можно изменить корень проекта, переместив весь проект в файловую систему и снова открыв проект в новом расположении. Все пути к файлам проекта сохраняются как относительные пути.
Просмотрите или измените папку Start Up. По умолчанию устанавливается корневой каталог проекта. При открытии проекта текущая рабочая папка изменяется на корневую папку проекта. Можно указать другую папку запуска или нажать кнопку Очистить.
Просмотр или изменение папки кэша моделирования и папки создания кода.
Чтобы изменить корень проекта по умолчанию для новых проектов, на вкладке Главная страница MATLAB (MATLAB Home) в разделе Среда (Environment) щелкните Настройки (Preferences). Выберите MATLAB > Проект и укажите папку по умолчанию.
Можно задать файлы проекта, такие как сценарии MATLAB и модели Simulink ®, для запуска, открытия или закрытия при открытии или закрытии проекта.
3. Чтобы настроить существующий файл для запуска при запуске и завершении работы проекта или задать параметры среды, нажмите кнопку «Завершение работы при запуске» на вкладке «Проект». В диалоговом окне «Управление запуском и завершением работы проекта»
Добавление или удаление файлов запуска и завершения работы. Если порядок выполнения важен, измените порядок с помощью кнопок со стрелками.
Используйте флажки для задания параметров среды. Выберите «Запустить Simulink» перед запуском проекта, чтобы запустить Simulink при открытии проекта. Выберите «Обновить настройки Simulink» для запуска sl_customization файлы при запуске и завершении работы проекта.
Создайте ярлыки проекта для общих задач, чтобы упростить поиск важных файлов и операций и доступ к ним. Например, поиск и открытие моделей верхнего уровня, выполнение кода и моделирование моделей.
4. На вкладке Ярлыки проекта (Project Shortcuts) этот пример проекта содержит ярлыки для модели верхнего уровня, утилитную функцию для перестроения s-функций и документ описания конструкции.
Щелкните ярлык F14 Model для открытия корневой модели для этого проекта.
Щелкните ярлык Перестроить S-функции проекта (Rebuild Project's S-functions), чтобы создать S-функцию.
Нажмите кнопку «Создать ярлык» для создания новых ярлыков для файла проекта.
Щелкните правой кнопкой мыши ярлык и выберите Править ярлык (Edit Shortcut), чтобы изменить ярлык.
На вкладке Проект в разделе Система управления версиями щелкните Сведения о SVN.
5. Диалоговое окно «Информация системы управления версиями» используется для:
Просмотр папки расположения репозитория. Можно изменить корень проекта, переместив весь проект в файловую систему и снова открыв проект в новом расположении. Все пути к файлам проекта сохраняются как относительные пути.
Просмотр или изменение используемой интеграции системы управления версиями.
6. В представлении «Файлы» выберите представление «Проект» (количество файлов) для управления файлами в проекте. В этом представлении отображаются только те файлы, которые являются частью проекта.
7. Используйте представление «Все» для просмотра всех файлов в рабочей копии. Здесь отображаются все файлы, находящиеся под корнем проекта, а не только файлы, находящиеся в проекте. Это представление полезно для добавления файлов в проект из рабочей копии.
8. Используйте представление Измененные (количество файлов), чтобы просмотреть измененные файлы перед внесением изменений в систему управления версиями. Представление измененных файлов отображается только при использовании системы управления версиями в проекте.
9. В любом представлении «Файлы» в правом верхнем углу измените формат с «Дерево» на «Список» для просмотра файлов в виде списка. Нажмите кнопку «Упорядочить вид
» для настройки видов и сортировки файлов.
Столбец SVN содержит информацию системы управления версиями для отдельных файлов, таких как «Без изменений», «Добавлено», «Изменено» или «Удалено».
10. Откройте и внесите изменения в одну из моделей в models или в один из файлов MATLAB в utility папка. Например, добавить комментарий в find_top_models.m в utility папка.
11. Для просмотра, анализа и фиксации измененных или добавленных файлов проекта используется представление «Измененное (количество файлов)». Вы видите:
Файл, в который были внесены изменения, например: find_top_models.m.
Файлы, хранящиеся в папке ресурсов/проекта. Это внутренние файлы определений проекта, созданные в результате изменений. Файлы определений проекта позволяют добавлять метаданные в файлы, например, путем создания ярлыков, добавления меток и добавления описания проекта. Файлы определений проекта также определяют файлы, которые добавляются в проект. Можно просматривать изменения в редакциях файлов определений проекта, как и любые другие файлы проекта.
12. Чтобы просмотреть изменения в измененном файле, щелкните правой кнопкой мыши выбранный файл, например: find_top_models.m
Выберите Сравнить > Сравнить с предком, чтобы выполнить сравнение с локальным репозиторием Git.
Выберите «Сравнить» > «Сравнить с редакцией», чтобы сравнить файл с другими редакциями.
13. Инструмент сравнения суммирует результаты в отчете. Фиолетовый цвет обозначает измененные элементы, синий - вставленные элементы, желтый - удаленные элементы. Чтобы сохранить версию отчета для печати, выберите Опубликовать > HTML, Word или PDF.
14. Если изменения удовлетворены, на вкладке Проект нажмите кнопку Зафиксировать, чтобы зафиксировать изменения в системе управления версиями.
15. Используйте анализатор зависимостей для визуального исследования зависимостей и изучения структуры проекта. На вкладке Проект в разделе Сервис щелкните Анализатор зависимостей.
Анализатор зависимостей суммирует результаты на панели справа. В нем перечислены имена используемых продуктов и надстроек. Он обнаруживает такие проблемы, как отсутствие файлов, файлы, отсутствующие в проекте, несохраненные изменения и устаревшие производные файлы. В этом примере анализатор идентифицирует файл «Not in project» и помечает его предупреждающим знаком.
16. Чтобы выделить проблемные файлы, в разделе Проблемы укажите сообщение о проблеме и щелкните лупу. В этом примере timesthree.mexw64 file требуется проектом, но в настоящее время не является его частью. Щелкните правой кнопкой мыши timesthree.mexw64 и выберите «Добавить в проект» или «Скрыть предупреждения». При следующем выполнении анализа зависимостей анализатор не помечает этот файл как проблему.
17. Выполните анализ воздействия на выбранный файл.
Анализ воздействия показывает, как изменение влияет на другие файлы перед внесением изменения. Например, чтобы найти необходимые файлы для timesthree.mexw64 для правильной работы щелкните правой кнопкой мыши timesthree.mexw64 и выберите «Найти обязательный». Поиск способов изменения timesthree.mexw64 файлы воздействия, щелкните правой кнопкой мыши timesthree.mexw64 и выберите «Найти затронутые».
Разрешение конфликтов при трехстороннем слиянии Simulink
Выполнение анализа воздействия с помощью проекта
Выполнение настраиваемых задач с проектом