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

Этот пример использует пример проекта 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);

Похожие темы

Для просмотра документации необходимо авторизоваться на сайте