exponenta event banner

Исследуйте пример проекта

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

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

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

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

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

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

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

Setup файлов примера

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

matlab.project.example.timesTable

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

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

Чтобы просмотреть файлы в проекте, в представлении Files, нажмите Project (number of files). Когда вид выбран, отображаются только файлы в проекте.

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Выберите представление файлы.

  2. Щелкните правой кнопкой по пустому пространству и выберите New > Folder. Введите имя папки. Папка автоматически добавляется в проект.

  3. Щелкните правой кнопкой мыши новую папку и выберите Project Path > Add to the Project Path (Включая подпапки).

Обзор изменений в измененных файлах

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

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

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

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

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

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

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

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

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

  1. На вкладке Project нажмите Dependency Analyzer.

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

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

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

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

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

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

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

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

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

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

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

Запуск проверок целостности проекта

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

Фиксация измененных файлов

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

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

  2. Чтобы зафиксировать изменения в системе контроля версий, на вкладке Project, в разделе «Система контроля версий», нажмите Commit.

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

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

Чтобы просмотреть и отредактировать сведения о проекте, на вкладке Project, в разделе Environment, нажмите Details. Просмотрите и измените сведения о проекте, такие как имя, описание, корень проекта, папка запуска и расположение папок, содержащих сгенерированные файлы.

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

Закройте проект

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

proj = currentProject;
close(proj);

Похожие темы