Этот пример использует пример проекта Times Table App, чтобы выяснить, как инструменты проекта могут помочь вам организовать работу.
На примере приложения Times Table App мы рассмотрим, как:
Настройте и просмотрите некоторые примеры файлов проекта под системой контроля версий.
Исследуйте ярлыки проекта, чтобы получить доступ к часто используемым файлам и задачам.
Анализируйте зависимости в проекте и находите необходимые файлы, которые еще не находятся в проекте.
Изменяйте некоторые файлы проекта, находите и просматривайте измененные файлы, сравнивайте их с более ранней версией и фиксируйте измененные файлы в системе контроля версий.
Исследуйте представления только файлов проекта, измененных файлов и всех файлов в корневой папке проекта.
Создайте рабочую копию Таблицы 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.
Создайте новую папку и добавьте ее в путь проекта. Добавление папки проекта к пути проекта гарантирует, что все пользователи проекта смогут получить доступ к файлам в нем.
Выберите представление файлы.
Щелкните правой кнопкой по пустому пространству и выберите New > Folder. Введите имя папки. Папка автоматически добавляется в проект.
Щелкните правой кнопкой мыши новую папку и выберите Project Path > Add to the Project Path (Включая подпапки).
Откройте файлы, внесите изменения и проверьте изменения.
Выберите представление файлы. Просмотрите папки с помощью размещения дерева, а затем разверните utilities
папка.
Щелкните правой кнопкой мыши source/timesTableGame.m
и выберите Open.
Внесите изменения в редакторе, например, добавьте комментарий, и сохраните файл.
В представлении файлы выберите Modified (number of files
) вкладка. После редактирования файла вы увидите Измененный (2). Файл, который вы изменили, появится в списке.
Чтобы просмотреть изменения, щелкните правой кнопкой мыши source/timesTableGame.m
в представлении Измененные файлы и выберите Сравнить > Сравнить с предком. MATLAB Comparison Tool открывает отчет о сравнении измененной версии файла в изолированной программной среде с его предком, хранящимся в системе контроля версий. Тип отчета о сравнении может отличаться в зависимости от выбранного файла. Если вы выбираете модель Simulink ® для сравнения, эта команда запускает сравнение модели Simulink.
* Примечание - Когда вы открываете пример проекта Times Table App, проект показывает измененный файл в resources
папка. Это побочный эффект открытия примера проекта. При редактировании файлов в собственных проектах только изменения, которые влияют на метаданные файла, такие как добавление метки к файлу, создают измененные файлы в resources
папка.
Чтобы проверить, все необходимые файлы находятся в проекте, запустите анализ зависимостей файлов от измененных файлов.
На вкладке Project нажмите Dependency Analyzer.
График зависимостей отображает структуру всех проанализированных зависимостей в проекте. На правой панели перечислены необходимые дополнения и любые файлы проблем. Обратите внимание, что в списке нет файлов проблем.
Теперь удалите один из необходимых файлов. Выберите ракурс project Files, щелкните правой кнопкой мыши по source/timesTableGame.m
Файл и выберите «Удалить из проекта». Нажмите кнопку Удалить (Remove) в диалоговом окне Удалить из проекта (Remove from Project
Анализатор Зависимостей автоматически обновляет график и раздел Problems на панели свойств.
Еще раз проверьте на наличие проблем.
В Анализаторе Зависимостей, на панели Свойства, укажите на сообщение о проблеме, Not in project
, в разделе Задачи и щелкните лупу. График обновляется, чтобы выделить файл задачи, timesTableGame.m.
Чтобы просмотреть зависимости файла задачи, в разделе Анализ влияния, нажмите Все зависимости.
Теперь, когда вы видели проблему, исправьте ее, вернув отсутствующий файл в проект. Щелкните файл правой кнопкой мыши и выберите «Добавить в проект». При следующем запуске анализа зависимостей файл не отображается как файл задачи.
После выполнения анализа зависимостей, чтобы исследовать зависимости измененных файлов, выполните анализ влияния.
В разделе «Представления» выберите «Система контроля версий». График окрашивает файлы по статусу системы контроля версий.
Выберите измененные файлы в графике или в списке файлов.
Чтобы просмотреть зависимости измененных файлов, в разделе «Анализ влияния» нажмите «Все зависимости».
Чтобы убедиться, что ваши изменения готовы к фиксации, проверьте свой проект. На вкладке Project нажмите Run Checks, чтобы запустить проверку целостности проекта. Проверки ищут отсутствующие файлы, файлы для добавления в систему контроля версий или получения из системы контроля версий и другие проблемы. Диалоговое окно Checks предлагает автоматическое устранение обнаруженных проблем, когда это возможно. При нажатии кнопки Подробно (Details) в диалоговом окне Проверки (Checks) можно просмотреть рекомендуемые действия и решить, вносить ли изменения.
После изменения файлов и удовлетворения результатами проверок можно зафиксировать изменения в репозитории системы контроля версий.
В представлении файлы выберите Modified (number of files
) вкладка. Измененные файлы отображаются в списке.
Чтобы зафиксировать изменения в системе контроля версий, на вкладке Project, в разделе «Система контроля версий», нажмите Commit.
Введите комментарий для отправки и нажмите кнопку Отправить. Следите за сообщениями в строке состояния, когда система контроля версий фиксирует ваши изменения. В Git можно иметь как локальные, так и удаленные репозитории. Эти инструкции фиксируются в локальном репозитории. Чтобы выполнить фиксацию в удаленном репозитории, в разделе «Система контроля версий» нажмите кнопку «Извлечь».
Чтобы просмотреть и отредактировать сведения о проекте, на вкладке Project, в разделе Environment, нажмите Details. Просмотрите и измените сведения о проекте, такие как имя, описание, корень проекта, папка запуска и расположение папок, содержащих сгенерированные файлы.
Чтобы просмотреть сведения об интегрировании с системой контроля версий и местоположении репозитория, на вкладке Project, в разделе «Система контроля версий», нажмите Git Details. В примере проекта приложения Times Table App используется система контроля версий Git.
Щелкните в правом верхнем углу окна проекта, чтобы закрыть проект.
proj = currentProject; close(proj);