В этом примере используется пример проекта Times Table App для изучения того, как инструменты проекта могут помочь организовать работу.
На примере приложения Times Table мы рассмотрим, как:
Настройте и просмотрите некоторые примеры файлов проекта в системе управления версиями.
Проверьте ярлыки проекта, чтобы получить доступ к часто используемым файлам и задачам.
Проанализируйте зависимости в проекте и найдите необходимые файлы, которые еще не находятся в проекте.
Измените некоторые файлы проекта, найдите и просмотрите измененные файлы, сравните их с более ранней версией и зафиксируйте измененные файлы в системе управления версиями.
Просмотр только видов файлов проекта, измененных файлов и всех файлов в корневой папке проекта.
Создайте рабочую копию файлов проекта примера приложения Times Table и откройте проект. MATLAB ® копирует файлы в папку примеров, чтобы их можно было редактировать. Проект помещает файлы Git™ систему управления версиями.
matlab.project.example.timesTable
Можно просматривать, искать и сортировать файлы проекта с помощью представления «Файлы».
Для просмотра файлов в проекте в представлении «Файлы» выберите «Проект» (number of files). Если выбран вид, отображаются только файлы в проекте.
Чтобы просмотреть все файлы в папке проекта, нажмите кнопку «» Все «». В этом представлении отображаются все файлы, находящиеся под корнем проекта, а не только файлы, находящиеся в проекте. В результате этот вид полезен для добавления файлов в проект.
Чтобы просмотреть файлы в виде списка, а не дерева, в поле Макет (Layout) в правом верхнем углу представления Файлы (Files) выберите Список (List).
Существует несколько способов поиска файлов и папок в проектах:
Для поиска определенных файлов или типов файлов по имени в любом представлении файла введите в поле поиска или нажмите кнопку «Фильтр». Например, в поле поиска введите текст timestable. Проект возвращает все файлы и папки, содержащие слово timestable. Щелкните значок
, чтобы отменить поиск.
Для поиска содержимого файлов перейдите на вкладку «Проект» и нажмите кнопку «Поиск». Введите значение в поле поиска и нажмите Enter. Например, введите слово tests. В проекте отображаются все файлы и папки, содержащие слово tests. Щелкните значок
, чтобы отменить поиск.
Чтобы изменить способ группировки или сортировки файлов и настроить столбцы, нажмите
кнопку Действия и выберите один из доступных параметров.
Для упрощения поиска файлов в крупном проекте можно использовать ярлыки. Просмотрите и запустите ярлыки на вкладке «Ярлыки проекта». Ярлыки можно упорядочить по группам.
Проект Times Table App содержит несколько ярлыков, включая ярлык для открытия требований проекта и другой для выполнения всех тестов в проекте. Ярлыки упрощают выполнение этих задач для пользователей проекта.
Чтобы выполнить действие, на вкладке Ярлыки проекта (Project Shortcuts) щелкните связанный ярлык. Например, чтобы открыть требования проекта, щелкните Документация > Требования. Чтобы запустить тесты, щелкните Тест > Выполнить все тесты.
Чтобы создать новый ярлык, выберите вид «Файлы», щелкните файл правой кнопкой мыши и выберите «Создать ярлык».
Создайте новую папку и добавьте ее в путь проекта. Добавление папки проекта в путь к проекту обеспечивает доступ всех пользователей проекта к файлам в нем.
Выберите вид «Файлы».
Щелкните правой кнопкой мыши в свободном пространстве и выберите «Создать» > «Папка». Введите имя папки. Папка автоматически добавляется в проект.
Щелкните правой кнопкой мыши новую папку и выберите «Путь к проекту» > «Добавить в путь к проекту» (включая вложенные папки).
Откройте файлы, внесите изменения и просмотрите изменения.
Выберите вид «Файлы». Просмотр папок с помощью структуры дерева, а затем разверните utilities папка.
Щелкните правой кнопкой мыши source/timesTableGame.m и выберите Открыть.
Внесите изменения в редактор, например добавление комментария, и сохраните файл.
В представлении «Файлы» выберите «Измененные» (number of files) вкладка. После редактирования файла появится раздел Изменено (2). Измененный файл появится в списке.
Для просмотра изменений щелкните правой кнопкой мыши source/timesTableGame.m в представлении Измененные файлы и выберите Сравнить > Сравнить с предком. Инструмент сравнения MATLAB открывает отчет о сравнении измененной версии файла в изолированной программной среде с его предком, сохраненным в системе управления версиями. Тип отчета о сравнении может отличаться в зависимости от выбранного файла. При выборе модели Simulink ® для сравнения эта команда запускает сравнение модели Simulink.
* Примечание - При открытии проекта примера приложения Times Table в проекте отображается измененный файл в resources папка. Это побочный эффект открытия примера проекта. При редактировании файлов в собственных проектах только изменения, влияющие на метаданные файлов, например добавление метки к файлу, создают измененные файлы в resources папка.
Чтобы убедиться, что все необходимые файлы находятся в проекте, выполните анализ зависимости файлов от измененных файлов.
На вкладке Проект (Project) щелкните Анализатор зависимостей (Dependency Analyzer).
На графике зависимостей отображается структура всех проанализированных зависимостей в проекте. На правой панели перечислены требуемые надстройки и все проблемные файлы. Обратите внимание, что в списке отсутствуют файлы с проблемами.
Теперь удалите один из обязательных файлов. Выберите вид «Файлы проекта», щелкните правой кнопкой мыши source/timesTableGame.m и выберите «Удалить из проекта». Нажмите кнопку «Удалить» в диалоговом окне «Удалить из проекта».
Анализатор зависимостей автоматически обновляет график и раздел Проблемы на панели Свойства.
Еще раз проверьте наличие проблем.
В анализаторе зависимостей на панели Свойства укажите на сообщение о проблеме, Not in project, в разделе Проблемы и щелкните лупу.
График обновляется для выделения файла проблемы. timesTableGame.m.
Чтобы просмотреть зависимости файла проблемы, в разделе Анализ воздействия щелкните Все зависимости.
Теперь, когда вы обнаружили проблему, устраните ее, вернув отсутствующий файл в проект. Щелкните файл правой кнопкой мыши и выберите «Добавить в проект». При следующем выполнении анализа зависимостей файл не отображается как файл проблем.
После выполнения анализа зависимостей, чтобы исследовать зависимости измененных файлов, выполните анализ воздействия.
В разделе «Виды» выберите «Система управления версиями». График окрашивает файлы по состоянию системы управления версиями.
Выберите измененные файлы на графике или в списке файлов.
Чтобы просмотреть зависимости измененных файлов, в разделе Анализ воздействия щелкните Все зависимости.
Чтобы убедиться, что изменения готовы к фиксации, проверьте проект. На вкладке Проект (Project) щелкните Выполнить проверки (Run Checks), чтобы выполнить проверки целостности проекта. При проверке будут найдены отсутствующие файлы, файлы для добавления в систему управления версиями или извлечения из системы управления версиями и другие проблемы. В диалоговом окне Проверки (Checks) по возможности выполняются автоматические исправления обнаруженных проблем. При нажатии кнопки Подробно (Details) в диалоговом окне Проверки (Checks) можно просмотреть рекомендуемые действия и решить, следует ли вносить изменения.
После изменения файлов и удовлетворения результатов проверок можно зафиксировать изменения в репозитории системы управления версиями.
В представлении «Файлы» выберите «Измененные» (number of files) вкладка. Измененные файлы появятся в списке.
Чтобы зафиксировать изменения в системе управления версиями, на вкладке Проект в разделе Система управления версиями нажмите кнопку Зафиксировать.
Введите комментарий для отправки и нажмите кнопку Отправить. Просмотр сообщений в строке состояния при подтверждении изменений системой управления версиями. В Git можно иметь как локальные, так и удаленные репозитории. Эти инструкции передаются в локальный репозиторий. Чтобы зафиксировать удаленное хранилище, в разделе Система управления версиями нажмите кнопку Извлечь.
Для просмотра и редактирования сведений о проекте на вкладке «Проект» в разделе «Среда» нажмите кнопку «Подробности». Просмотр и изменение сведений о проекте, таких как имя, описание, корневой каталог проекта, папка запуска и расположение папок, содержащих созданные файлы.
Чтобы просмотреть сведения об интеграции системы управления версиями и расположении репозитория, на вкладке «Проект» в разделе «Система управления версиями» нажмите кнопку «Получить сведения». В примере проекта приложения Times Table используется система управления версиями Git.
Щелкните в
правом верхнем углу окна проекта, чтобы закрыть проект.
proj = currentProject; close(proj);