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

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

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

  • Ваш проект (модель и файлы библиотеки, .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, можно просмотреть рекомендуемые действия и решить, внести ли изменения.

Для примера с помощью проверок проекта, чтобы устранить проблемы, смотрите, Преобразуют от MDL до 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.

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

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

Больше о