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

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

Попробуйте проект в качестве примера, чтобы видеть, как инструменты могут помочь вам организовать свою работу. Проекты могут помочь вам справиться:

  • Ваш проект (модель и файлы библиотеки, .m, .mat, и другие файлы, исходный код для S-функций и данные)

  • Набор действий, чтобы использовать с вашим проектом (код настройки выполнения, открытые модели, моделируют, создает, и код завершения работы выполнения),

  • При Работе с файлами под системой контроля версий (выезд, сравните версии, тег или метку и регистрацию),

Пример Корпуса показывает как:

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

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

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

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

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

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

Запустите эту команду, чтобы создать рабочую копию файлов проекта и открыть проект:

sldemo_slproject_airframe

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

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

Примечание

Также можно попробовать этот проект в качестве примера с помощью системы контроля версий SVN путем определения sldemo_slproject_airframe_svn. Следующий пример показывает варианты при использовании Git.

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

  1. В Проекте исследуйте представление Files, чтобы управлять файлами в рамках вашего проекта. Когда представление Project (number of files) выбрано, только файлы в вашем проекте показывают.

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

  3. Найти конкретные файлы или типы файлов, в любом представлении файла, типе в поле поиска или нажать кнопку Filter. Можно также искать внутренние файлы.

    Кликните по x, чтобы очистить поиск.

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

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

  6. Можно прикрепить и расстыковать Проект в MATLAB® Desktop. Если вы хотите максимизировать пробел для просмотра ваших файлов проекта, расстыкуйте Проект. Перетащите строку заголовка, чтобы расстыковать его.

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

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

В этом примере скрипт, который регенерирует S-функции, установлен как ярлык так, чтобы новый пользователь проекта мог легко найти его. Можно также сделать модель верхнего уровня или модели, в рамках проекта легче найти. В этом примере модель верхнего уровня, slproject_f14.mdl, является ярлыком.

Регенерируйте S-функции.

  1. На вкладке Project Shortcuts в панели инструментов кликните по ярлыку Rebuild Project's S-functions.

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

  2. Откройте файл rebuild_s_functions.m, чтобы исследовать, как он работает.

Откройте топ-модель.

  • На вкладке Project Shortcuts кликните по ярлыку F14 Model, чтобы открыть корневую модель для этого проекта.

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

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

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

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

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

  2. Или дважды кликните, чтобы открыть файл find_top_models для редактирования из проекта, или щелкнуть правой кнопкой и выбрать Open.

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

  4. В проекте представление Files выберите вкладку Modified (number of files). После редактирования файла вы видите Modified (2). Файлы, которые вы изменили, появляются в списке. Вы отредактировали файл в сервисной папке. Заметьте, что Измененный список файлов также включает папку resources. Файлы, хранившие в папке resources, являются внутренними файлами определения проекта, сгенерированными вашими изменениями. Файлы определения проекта позволяют вам добавлять метаданные в файлы, например, путем создания ярлыков, добавления меток и добавления описания проекта. Файлы определения проекта также задают файлы, которые добавляются к вашему проекту. Можно рассмотреть изменения в версиях файлов определения проекта как любые другие файлы проекта. Смотрите Файлы Определения Проекта.

  5. Чтобы рассмотреть изменения, щелкните правой кнопкой по файлу find_top_models по файлам Modified, просматривают и выбирают Compare> Compare to Ancestor.

    Инструмент Сравнения MATLAB открывает отчет, сравнивающий измененную версию файла в вашей песочнице против ее предка, сохраненного в инструменте системы контроля версий. Тип отчета сравнения может отличаться в зависимости от файла, который вы выбираете. Если вы выбираете модель Simulink® к Compare> Compare to Ancestor, эта команда запускает сравнение модели Simulink.

Чтобы сравнить модели, попробуйте следующий пример.

  1. В представлении Files выберите вкладку Project (number of files) и расширьте папку models.

  2. Или дважды кликните, чтобы открыть файл AnalogControl для редактирования из проекта, или щелкнуть правой кнопкой и выбрать Open.

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

  4. Чтобы рассмотреть изменения, выберите вкладку Modified (number of files). Щелкните правой кнопкой по измененному образцовому файлу и выберите Compare> Compare to Ancestor.

    Инструмент Сравнения открывает отчет.

Запустите анализ зависимостей

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

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

  2. Нажмите Analyze.

    График Влияния отображает структуру всех анализируемых зависимостей в проекте. Правая панель перечисляет требуемые тулбоксы и любые проблемные файлы.

  3. Чтобы просмотреть файлы, которые используют проблемный файл, наведите на сообщения под Problems и нажмите Find All.

    График обновляет, чтобы отобразить только проблемный файл и проблемное сообщение в правильной панели. Файл не находится в проекте. Чтобы просмотреть зависимости проблемного файла, на вкладке Dependency Analysis, в разделе Impact Analysis, выбирают Find> All Dependencies of Selection.

  4. Заметьте, что timesthree.mex64 является двоичным файлом S-функции, требуемым f14_airframe.slx. Можно добавить двоичные файлы в проект или, как в этом проекте, предоставить служебный скрипт, который регенерирует их из исходного кода, который является частью проекта.

  5. Чтобы удалить файл из проблемного списка файлов, щелкните правой кнопкой по файлу и выберите Add External File. В следующий раз, когда вы запускаете анализ зависимостей, файл не появляется как проблемный файл.

    В этом примере вы не хотите добавлять двоичный файл в проект, но вместо этого использовать скрипт, чтобы регенерировать двоичный файл из исходного кода в проекте. Используйте Add External File, чтобы остановить такие файлы, отмечаемые как проблемы.

  6. На вкладке Dependency Analysis, в разделе Impact Analysis, выбирают Find> All Files.

  7. В разделе Impact Analysis выберите Select> Modified Files.

  8. Чтобы просмотреть зависимости измененных файлов, в разделе Impact Analysis, выбирают Find > All Dependencies of Selection.

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

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

Для примера с помощью проверок проекта, чтобы устранить проблемы, смотрите Файлы Модели Обновления к SLX и Истории Версии Заповедника.

Фиксируйте измененные файлы

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

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

  2. Чтобы передать ваши изменения в системе контроля версий, на вкладке Project, в разделе Source Control, нажимают Commit.

  3. Введите комментарий для своего представления и нажмите Submit.

    См. сообщения в строке состояния, когда система контроля версий фиксирует ваши изменения. Git соглашается на ваш локальный репозиторий. Чтобы согласиться на удаленный репозиторий, используйте Push в разделе Source Control. Смотрите Получение по запросу, Нажатие и Файлы Выборки с Git

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

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

  • Чтобы посмотреть детали об интегрировании системы контроля версий и местоположении репозитория, на вкладке Project, в разделе Source Control, нажимают Git Details. Этот проект Корпуса в качестве примера использует систему контроля версий Git.

Также используйте API проекта, чтобы получить текущий проект:

project = currentProject;
Можно использовать API проекта, чтобы получить все детали проекта и управлять проектом в командной строке. Смотрите currentProject.

Для следующих шагов смотрите управление проектами.

Связанные примеры

Больше о