Использование проекта с Git

Открыть Live Script

В этом примере показано, как использовать проект для управления файлами в рамках вашего проекта. Начиная с существующего проекта, который уже возвращен в систему контроля версий, в этом примере показано, как просмотреть измененные файлы, сравнить версии файлов и проанализировать зависимости проекта.

Настройте файлы примера и откройте проект

Создайте и откройте рабочую копию файлов примера проекта. 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\airframe8"
       SourceControlMessages: ["Branch status: Normal"    "No remote tracking branch"    "Current branch: master"]
                    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\airframe8"
         SimulinkCacheFolder: "C:\workSpace\examples\airframe8\work\cache"
        ProjectStartupFolder: "C:\workSpace\examples\airframe8"
       SimulinkCodeGenFolder: "C:\workSpace\examples\airframe8\work\codegen"

Управление путем проекта

Когда вы открываете свой проект, MATLAB добавляет путь проекта к пути поиска файлов MATLAB перед применением ярлыков запуска.

Когда вы закрываете свой проект, MATLAB удаляет путь проекта из пути поиска файлов MATLAB после применения ярлыков завершения работы.

1. Чтобы добавить или удалить папки в путь проекта, на вкладке Project, в разделе Environment, нажмите Project Path:

Чтобы добавить папку (без подпапок) в путь проекта, нажмите Добавить папку. Если необходимо добавить папку и ее подпапки, нажмите кнопку Добавить с подпапками. Затем используйте диалоговое окно Открыть, чтобы добавить новую папку.
Чтобы удалить папку из пути проекта, из списка отображения, выберите папку. Затем нажмите кнопку Удалить.

Важно добавить файлы проекта к пути проекта, чтобы убедиться, что анализатор зависимостей обнаруживает все файлы проекта.

Укажите детали проекта, папку запуска и папки производных файлов

2. На вкладке Project, в разделе Environment, нажмите Details. Диалоговое окно «Сведения о проекте» используется для:

Отредактируйте имя проекта или добавьте описание.
Просмотр корневой папки Project. Изменить корень проекта можно путем перемещения всего проекта в файловой системе и повторного открытия проекта в его новом местоположении. Все пути к файлам проекта сохраняются как относительные пути.
Просмотр или изменение папки Start Up. По умолчанию это значение задается как корень проекта. Когда вы открываете проект, текущая рабочая папка изменяется на корневую папку проекта. Можно задать другую папку запуска или нажать кнопку Удалить.
Просмотр или изменение папки кэша симуляции и папки генерации кода.

Чтобы изменить корень проекта по умолчанию для новых проектов, на вкладке MATLAB Home, в разделе Environment, нажмите настройки. Выберите MATLAB > Project и укажите папку Default.

Автоматизация задач запуска и завершения работы

Можно задать файлы проекта, такие как скрипты MATLAB и модели Simulink ®, чтобы запускаться, открываться или закрываться, когда проект откроется или закроется.

3. Чтобы настроить существующий файл для запуска и завершения работы проекта или задать опции окружения, нажмите кнопку Startup Shutdown на вкладке Project. В диалоговом окне «Управление запуском и завершением работы проекта»

Добавьте или удалите файлы запуска и завершения работы. Если порядок выполнения важен, измените порядок с помощью кнопок со стрелами.
Установите флажки, чтобы задать опции окружения. Выберите Start Simulink, прежде чем этот проект начнет запускать Simulink, когда вы откроете проект. Выберите для запуска индивидуальные настройки Refresh Simulink sl_customization файлы при запуске и завершении работы проекта.

Ярлыки проекта для общих задач

Создайте ярлыки проекта для общих задач, чтобы упростить поиск и доступ к важным файлам и операциям. Для примера, поиска и открытия топовых моделей, запуска кода и симуляции моделей.

4. На вкладке Ярлыки проекта (Project Shortcuts) этот пример проекта имеет ярлыки для модели верхнего уровня, служебную функцию для перестройки s-функций и документ описания проекта.

Щелкните ярлык F14 Model чтобы открыть корневую модель для этого проекта.
Щелкните ярлык «Перестроить S-функции проекта», чтобы сгенерировать S-функцию.
Нажмите кнопку «Создать ярлык», чтобы создать новые ярлыки для файла проекта.
Щелкните правой кнопкой мыши ярлык и выберите «Редактировать ярлык» для редактирования ярлыка.

Просмотр информации о системе контроля версий

На вкладке Project, в Разделе системы контроля версий, нажмите Git Details.

5. Используйте диалоговое окно Информация о системе контроля версий, чтобы:

Просмотр папки Местоположения репозитория. Изменить корень проекта можно путем перемещения всего проекта в файловой системе и повторного открытия проекта в его новом местоположении. Все пути к файлам проекта сохраняются как относительные пути.
Просмотрите или измените используемое интегрирование с системой контроля версий.

Исследуйте представления файлов

6. В представлении Files выберите представление Project (количество файлов), чтобы управлять файлами в проекте. Это представление показывает только файлы, которые являются частью вашего проекта.

7. Используйте представление All, чтобы увидеть все файлы в рабочем копие. Это показывает все файлы, которые находятся под корнем проекта, а не только файлы, которые находятся в проекте. Это представление полезно для добавления файлов к проекту из рабочей копии.

8. Используйте представление Измененное (количество файлов), чтобы просмотреть измененные файлы перед фиксацией изменений в системе контроля версий. Представление измененных файлов видим только, если вы используете систему контроля версий с вашим проектом.

9. В любом представлении Files, в верхней части, измените размещение с Tree на List, чтобы просмотреть файлы как список. Нажмите кнопку «Организовать представление», чтобы настроить представления и отсортировать файлы.

Столбец Git предоставляет информацию о системе контроля версий для отдельных файлов, таких как Unmodified, Add, Modified или Deleted.

Просмотр измененных файлов и сравнение редакций

10. Откройте и внесите изменения в одну из моделей в models папка или в один из файлов MATLAB в utility папка. Например, добавить комментарий в find_top_models.mв utility папка.

11. Чтобы просмотреть, проанализировать и зафиксировать измененные или добавленные файлы проекта, используйте представление Modified (количество файлов). Вы видите:

Файл, в который вы внесли изменения, для примера find_top_models.m.
Файлы, хранящиеся в папке ресурсы/проект. Это внутренние файлы определения проекта, сгенерированные вашими изменениями. Файлы определения проекта позволяют добавлять метаданные к файлам, например, создавая ярлыки, добавляя метки и добавляя описание проекта. Файлы определения проекта также определяют файлы, которые добавляются к вашему проекту. Можно просмотреть изменения в редакциях файлов определения проекта, как и любые другие файлы проекта.

12. Чтобы просмотреть изменения в измененном файле, щелкните правой кнопкой мыши выбранный файл, например find_top_models.m

Выберите Сравнить > Сравнить с предком, чтобы запустить сравнение с локальным репозиторием Git.
Выберите команду Сравнить (Compare) > Сравнить с ревизией (Compare to Revision), чтобы сравнить файл с другими ревизиями.

13. Инструмент сравнения результирует результаты в отчете. Purple указывает измененные элементы, синий - вставленные элементы, а желтый - удаленные элементы. Чтобы сохранить версию отчета для печати, выберите Publish > HTML, Word или PDF.

14. Если вы довольны изменениями, на вкладке Project нажмите кнопку Commit, чтобы зафиксировать изменения в системе контроля версий.

Анализируйте зависимости проекта

15. Используйте Анализатор Зависимостей, чтобы исследовать зависимости визуально и исследовать структуру вашего проекта. На вкладке Project, в разделе Tools, нажмите Dependency Analyzer.

Анализатор Зависимостей суммирует результаты на панели справа. В нем перечислены имена используемых продуктов и дополнений. Это обнаруживает проблемы, такие как недостающие файлы, файлы не в проекте, неспасенных изменениях и устаревших производных файлах. В этом примере анализатор идентифицирует файл «Не в проекте» и помечает его предупреждающим знаком.

16. Чтобы выделить файлы задачи, в разделе Problems, укажите на сообщение задачи и щелкните лупу. В этом примере timesthree.mexw64 file требуется для проекта, но в настоящее время не является его частью. Щелкните правой кнопкой мыши timesthree.mexw64 и выберите «Добавить в проект» или «Скрыть предупреждения». При следующем запуске анализа зависимостей анализатор не отметит этот файл как проблему.

17. Выполните анализ влияния на выбранный файл.

Анализ влияния показывает, как изменение влияет на другие файлы до внесения изменения. Например, чтобы найти необходимые файлы для timesthree.mexw64 для правильного выполнения щелкните правой кнопкой мыши timesthree.mexw64 и выберите Find Required. Чтобы найти изменения в timesthree.mexw64 файлы влияния , щелкните правой кнопкой мыши timesthree.mexw64 и выберите Find Impacted.