В этом примере показано, как использовать проект управлять файлами в рамках вашего проекта. Начиная с существующего проекта, который уже проверяется в систему контроля версий, этот пример показывает, как просмотреть модифицированные файлы, сравнить версии файла и анализировать зависимости от проекта.
Создайте и откройте рабочую копию файлов проекта в качестве примера. MATLAB® копирует файлы в папку в качестве примера так, чтобы можно было отредактировать их. Проект в качестве примера находится под системой контроля версий Git™.
sldemo_slproject_airframe
Building with 'MinGW64 Compiler (C)'. MEX completed successfully.
ans =
Project with properties:
Name: "Airframe Example"
SourceControlIntegration: "Git"
RepositoryLocation: "C:\workSpace\examples\repositories\airframe"
SourceControlMessages: ["Current branch: master" "No remote tracking branch" "Branch status: Normal"]
ReadOnly: 0
TopLevel: 1
Dependencies: [1×1 digraph]
Categories: [1×1 matlab.project.Category]
Files: [1×32 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\airframe"
SimulinkCodeGenFolder: "C:\workSpace\examples\airframe\work\codegen"
ProjectStartupFolder: "C:\workSpace\examples\airframe"
SimulinkCacheFolder: "C:\workSpace\examples\airframe\work\cache"
Когда вы открываете свой проект, MATLAB добавляет путь к проекту к пути поиска файлов MATLAB прежде, чем применить ярлыки запуска.
Когда вы закрываете свой проект, MATLAB удаляет путь к проекту из пути поиска файлов MATLAB после применения ярлыков завершения работы.
1. Чтобы добавить или удалить папки к пути к проекту, на вкладке Project, в разделе Environment, нажимают Project Path:
Чтобы добавить папку (без подпапок) к пути к проекту, нажмите Add Folder. Если вы хотите добавить папку и ее подпапки, нажмите Add with Subfolders вместо этого. Затем используйте диалоговое окно Open, чтобы добавить новую папку.
Чтобы удалить папку из пути к проекту, из дисплейного списка, выбирают папку. Затем нажмите Remove.
Важно добавить файлы проекта в путь к проекту, чтобы гарантировать Зависимость, Анализатор обнаруживает все файлы проекта.
2. На вкладке Project, в разделе Environment, нажимают Details. Используйте диалоговое окно Project Details для:
Отредактируйте название проекта или добавьте описание.
Просмотрите корневую папку Проекта. Можно изменить корень проекта путем перемещения целого проекта в файловую систему и повторного открытия проекта в его новом местоположении. Все пути к файлам проекта хранятся как относительные пути.
Просмотрите или отредактируйте папку Start Up. По умолчанию это установлено в корень проекта. Когда вы открываете проект, текущая рабочая папка превращается в корневую папку проекта. Можно задать различную папку запуска или нажать Clear.
Просмотрите или отредактируйте папку кэша Симуляции и папку Генерации кода.
Чтобы изменить проект по умолчанию поддерживают новые проекты, на вкладке MATLAB Home, в разделе Environment, нажимают Preferences. Выберите MATLAB> Project и задайте папку Default.
Можно установить файлы проекта, такие как скрипты MATLAB и модели Simulink®, чтобы запуститься, открыться, или закрыться, когда проект открывается или закрывается.
3. Чтобы сконфигурировать существующий файл, чтобы работать на запуске проекта и завершении работы, или задать опции среды, нажимают Startup Shutdown button во вкладке Project. В диалоговом окне Manage Project Startup and Shutdown
Добавьте или удалите файлы запуска и завершения работы. Если порядок выполнения важен, измените порядок с помощью кнопок стрелки.
Используйте флажки, чтобы задать опции среды. Выберите Start Simulink, прежде чем этот проект начнет запускать Simulink, когда вы открываете проект. Выберите индивидуальные настройки Refresh Simulink, чтобы запустить sl_customization файлы на запуске проекта и завершении работы.
Создайте ярлыки проекта для общих задач дать возможность находить и получать доступ к важным файлам и операциям. Например, найдите и открытые модели, код запуска, и симулируйте модели.
4. На вкладке Project Shortcuts этот проект в качестве примера имеет ярлыки для модели верхнего уровня, служебная функция, чтобы восстановить s-функции и документ описания проекта.
Кликните по ярлыку F14 Model открыть корневую модель для этого проекта.
Щелкните ярлык Восстанавливают S-функции Проекта, чтобы сгенерировать S-функцию.
Нажмите New Shortcut button, чтобы создать новые ярлыки для файла проекта.
Щелкните правой кнопкой по ярлыку и выберите Edit Shortcut, чтобы отредактировать ярлык.
На вкладке Project, в разделе Source Control, нажимают Git Details.
5. Используйте диалоговое окно Source Control Information для:
Просмотрите папку Местоположения репозитория. Можно изменить корень проекта путем перемещения целого проекта в файловую систему и повторного открытия проекта в его новом местоположении. Все пути к файлам проекта хранятся как относительные пути.
Просмотрите или измените используемое интегрирование системы контроля версий.
6. В представлении Files выберите Project (количество файлов) представление, чтобы управлять файлами в рамках вашего проекта. Это представление только показывает файлы, которые являются частью вашего проекта.
7. Используйте Все представление, чтобы видеть все файлы в вашей рабочей копии. Это показывает все файлы, которые находятся под корнем проекта, не только файлами, которые находятся в проекте. Это представление полезно для добавления файлов к вашему проекту из вашей рабочей копии.
8. Используйте Модифицированное (количество файлов) представление, чтобы рассмотреть модифицированные файлы прежде, чем передать ваши изменения в системе контроля версий. Модифицированное представление файлов отображается, только если вы используете систему контроля версий со своим проектом.
9. В любом представлении Files, в правом верхнем, изменяют размещение от Дерева до Списка, чтобы просмотреть файлы как список. Нажмите кнопку Organize View
, чтобы настроить представления и отсортировать файлы.
Столбец Git предоставляет информацию о системе контроля версий об отдельных файлах такой как Немодифицированную, Добавленную, Модифицированную, или Удаленную.
10. Откройте и внесите изменение в одну из моделей в models папка или к одному из файлов MATLAB в utility папка. Например, добавьте комментарий in find_top_models.m в utility папка.
11. Чтобы рассмотреть, анализируйте, и фиксируйте измененные или добавленные файлы проекта, используйте Модифицированное (количество файлов) представление. Вы видите:
Файл вы внесли изменения в, например, find_top_models.m.
Файлы хранятся в папке ресурсов/проекта. Это внутренние файлы определения проекта, сгенерированные вашими изменениями. Файлы определения проекта позволяют вам добавлять метаданные в файлы, например, путем создания ярлыков, добавления меток и добавления описания проекта. Файлы определения проекта также задают файлы, которые добавляются к вашему проекту. Можно рассмотреть изменения в версиях файлов определения проекта как любые другие файлы проекта.
12. Чтобы рассмотреть изменения в модифицированном файле, щелкните правой кнопкой по выбранному файлу, например, find_top_models.m
Выберите Compare> Compare to Ancestor, чтобы запустить сравнение с локальным репозиторием Git.
Выберите Compare> Compare to Revision, чтобы сравнить файл с другими версиями.
13. Инструмент Сравнения обобщает результаты в отчете. Фиолетовый указывает, что измененные элементы, синие, указывает, что вставленные элементы, и желтый указывают на удаленные элементы. Чтобы сохранить версию для печати отчета, выберите Publish> HTML, Word или PDF.
14. Если вы довольны своими изменениями, на вкладке Project, нажимаете кнопку Commit, чтобы передать ваши изменения в системе контроля версий.
15. Используйте Зависимость Анализатор, чтобы исследовать зависимости визуально и исследовать структуру вашего проекта. На вкладке Project кликните по стрелке вниз, чтобы расширить галерею Tools. В соответствии с Приложениями, нажмите Dependency Analyzer.
Зависимость Анализатор обобщает результаты в панели справа. Это перечисляет имена используемых продуктов и Дополнений. Это обнаруживает проблемы, такие как недостающие файлы, файлы не в проекте, несохраненных изменениях и устаревших производных файлах. В этом примере анализатор идентифицирует "Файл не в проекте" и помечает его с предупредительным знаком
.
16. Чтобы подсветить проблемные файлы, в проблемном разделе, точка к проблеме передает и кликает по лупе. В этом примере, timesthree.mexw64 file требуется проектом, но не в настоящее время часть его. Щелкните правой кнопкой по timesthree.mexw64 и выберите Add to Project или Hide Warnings. В следующий раз, когда вы запускаете анализ зависимостей, анализатор не отметит этот файл как проблема.
17. Выполните анализ удара выбранного файла.
Анализ удара показывает вам, как изменение влияет на другие файлы, прежде чем вы внесете изменение. Например, чтобы найти требуемые файлы для timesthree.mexw64 чтобы запуститься правильно, щелкните правой кнопкой по timesthree.mexw64 и выберите Find Required. Найти как изменения в timesthree.mexw64 повлияйте на files, щелкните правой кнопкой по timesthree.mexw64 и выберите Find Impacted.
Разрешите конфликты с Simulink слияние с тремя путями
Выполните анализ влияния в проекте
Запустите пользовательские задачи с проектом