exponenta event banner

Изучение примера проекта

В этом примере используется пример проекта Times Table App для изучения того, как инструменты проекта могут помочь организовать работу.

На примере приложения Times Table мы рассмотрим, как:

  1. Настройте и просмотрите некоторые примеры файлов проекта в системе управления версиями.

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

  3. Проанализируйте зависимости в проекте и найдите необходимые файлы, которые еще не находятся в проекте.

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

  5. Просмотр только видов файлов проекта, измененных файлов и всех файлов в корневой папке проекта.

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

Создайте рабочую копию файлов проекта примера приложения Times Table и откройте проект. MATLAB ® копирует файлы в папку примеров, чтобы их можно было редактировать. Проект помещает файлы Git™ систему управления версиями.

matlab.project.example.timesTable

Просмотр, поиск и сортировка файлов проекта

Можно просматривать, искать и сортировать файлы проекта с помощью представления «Файлы».

Для просмотра файлов в проекте в представлении «Файлы» выберите «Проект» (number of files). Если выбран вид, отображаются только файлы в проекте.

Чтобы просмотреть все файлы в папке проекта, нажмите кнопку «» Все «». В этом представлении отображаются все файлы, находящиеся под корнем проекта, а не только файлы, находящиеся в проекте. В результате этот вид полезен для добавления файлов в проект.

Чтобы просмотреть файлы в виде списка, а не дерева, в поле Макет (Layout) в правом верхнем углу представления Файлы (Files) выберите Список (List).

Существует несколько способов поиска файлов и папок в проектах:

  • Для поиска определенных файлов или типов файлов по имени в любом представлении файла введите в поле поиска или нажмите кнопку «Фильтр». Например, в поле поиска введите текст timestable. Проект возвращает все файлы и папки, содержащие слово timestable. Щелкните значок, чтобы отменить поиск.

  • Для поиска содержимого файлов перейдите на вкладку «Проект» и нажмите кнопку «Поиск». Введите значение в поле поиска и нажмите Enter. Например, введите слово tests. В проекте отображаются все файлы и папки, содержащие слово tests. Щелкните значок, чтобы отменить поиск.

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

Открытие и выполнение часто используемых файлов

Для упрощения поиска файлов в крупном проекте можно использовать ярлыки. Просмотрите и запустите ярлыки на вкладке «Ярлыки проекта». Ярлыки можно упорядочить по группам.

Проект Times Table App содержит несколько ярлыков, включая ярлык для открытия требований проекта и другой для выполнения всех тестов в проекте. Ярлыки упрощают выполнение этих задач для пользователей проекта.

Чтобы выполнить действие, на вкладке Ярлыки проекта (Project Shortcuts) щелкните связанный ярлык. Например, чтобы открыть требования проекта, щелкните Документация > Требования. Чтобы запустить тесты, щелкните Тест > Выполнить все тесты.

Чтобы создать новый ярлык, выберите вид «Файлы», щелкните файл правой кнопкой мыши и выберите «Создать ярлык».

Добавить папку в проект

Создайте новую папку и добавьте ее в путь проекта. Добавление папки проекта в путь к проекту обеспечивает доступ всех пользователей проекта к файлам в нем.

  1. Выберите вид «Файлы».

  2. Щелкните правой кнопкой мыши в свободном пространстве и выберите «Создать» > «Папка». Введите имя папки. Папка автоматически добавляется в проект.

  3. Щелкните правой кнопкой мыши новую папку и выберите «Путь к проекту» > «Добавить в путь к проекту» (включая вложенные папки).

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

Откройте файлы, внесите изменения и просмотрите изменения.

  1. Выберите вид «Файлы». Просмотр папок с помощью структуры дерева, а затем разверните utilities папка.

  2. Щелкните правой кнопкой мыши source/timesTableGame.m и выберите Открыть.

  3. Внесите изменения в редактор, например добавление комментария, и сохраните файл.

  4. В представлении «Файлы» выберите «Измененные» (number of files) вкладка. После редактирования файла появится раздел Изменено (2). Измененный файл появится в списке.

  5. Для просмотра изменений щелкните правой кнопкой мыши source/timesTableGame.m в представлении Измененные файлы и выберите Сравнить > Сравнить с предком. Инструмент сравнения MATLAB открывает отчет о сравнении измененной версии файла в изолированной программной среде с его предком, сохраненным в системе управления версиями. Тип отчета о сравнении может отличаться в зависимости от выбранного файла. При выборе модели Simulink ® для сравнения эта команда запускает сравнение модели Simulink.

* Примечание - При открытии проекта примера приложения Times Table в проекте отображается измененный файл в resources папка. Это побочный эффект открытия примера проекта. При редактировании файлов в собственных проектах только изменения, влияющие на метаданные файлов, например добавление метки к файлу, создают измененные файлы в resources папка.

Анализ зависимостей

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

  1. На вкладке Проект (Project) щелкните Анализатор зависимостей (Dependency Analyzer).

  2. На графике зависимостей отображается структура всех проанализированных зависимостей в проекте. На правой панели перечислены требуемые надстройки и все проблемные файлы. Обратите внимание, что в списке отсутствуют файлы с проблемами.

Теперь удалите один из обязательных файлов. Выберите вид «Файлы проекта», щелкните правой кнопкой мыши source/timesTableGame.m и выберите «Удалить из проекта». Нажмите кнопку «Удалить» в диалоговом окне «Удалить из проекта».

Анализатор зависимостей автоматически обновляет график и раздел Проблемы на панели Свойства.

Еще раз проверьте наличие проблем.

  1. В анализаторе зависимостей на панели Свойства укажите на сообщение о проблеме, Not in project, в разделе Проблемы и щелкните лупу. График обновляется для выделения файла проблемы. timesTableGame.m.

  2. Чтобы просмотреть зависимости файла проблемы, в разделе Анализ воздействия щелкните Все зависимости.

Теперь, когда вы обнаружили проблему, устраните ее, вернув отсутствующий файл в проект. Щелкните файл правой кнопкой мыши и выберите «Добавить в проект». При следующем выполнении анализа зависимостей файл не отображается как файл проблем.

После выполнения анализа зависимостей, чтобы исследовать зависимости измененных файлов, выполните анализ воздействия.

  1. В разделе «Виды» выберите «Система управления версиями». График окрашивает файлы по состоянию системы управления версиями.

  2. Выберите измененные файлы на графике или в списке файлов.

  3. Чтобы просмотреть зависимости измененных файлов, в разделе Анализ воздействия щелкните Все зависимости.

Выполнение проверок целостности проекта

Чтобы убедиться, что изменения готовы к фиксации, проверьте проект. На вкладке Проект (Project) щелкните Выполнить проверки (Run Checks), чтобы выполнить проверки целостности проекта. При проверке будут найдены отсутствующие файлы, файлы для добавления в систему управления версиями или извлечения из системы управления версиями и другие проблемы. В диалоговом окне Проверки (Checks) по возможности выполняются автоматические исправления обнаруженных проблем. При нажатии кнопки Подробно (Details) в диалоговом окне Проверки (Checks) можно просмотреть рекомендуемые действия и решить, следует ли вносить изменения.

Зафиксировать измененные файлы

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

  1. В представлении «Файлы» выберите «Измененные» (number of files) вкладка. Измененные файлы появятся в списке.

  2. Чтобы зафиксировать изменения в системе управления версиями, на вкладке Проект в разделе Система управления версиями нажмите кнопку Зафиксировать.

  3. Введите комментарий для отправки и нажмите кнопку Отправить. Просмотр сообщений в строке состояния при подтверждении изменений системой управления версиями. В Git можно иметь как локальные, так и удаленные репозитории. Эти инструкции передаются в локальный репозиторий. Чтобы зафиксировать удаленное хранилище, в разделе Система управления версиями нажмите кнопку Извлечь.

Просмотр сведений о проекте и системе управления версиями

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

Чтобы просмотреть сведения об интеграции системы управления версиями и расположении репозитория, на вкладке «Проект» в разделе «Система управления версиями» нажмите кнопку «Получить сведения». В примере проекта приложения Times Table используется система управления версиями Git.

Закрыть проект

Щелкните в правом верхнем углу окна проекта, чтобы закрыть проект.

proj = currentProject;
close(proj);

Связанные темы