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

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

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

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

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

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

Пример Airframe показывает, как:

  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 view в крайнем правом углу поля поиска.

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

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

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

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

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

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

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

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

Откройте верхнюю часть.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. Чтобы выделить файлы задачи, на панели Properties, в разделе Problems, укажите Not in Project сообщения и щелкните значок лупы.

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

  4. Чтобы удалить файл из списка файлов проблем, щелкните правой кнопкой мыши файл и выберите Hide Warnings. При следующем запуске анализа зависимостей файл не отображается как файл задачи.

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

  5. Просмотрите зависимости измененных файлов.

    1. На панели инструментов анализатора зависимостей, в разделе Views, нажмите Source Control. Цвет каждого файла в графике теперь представляет его статус системы контроля версий.

    2. В графике зависимостей выберите измененные файлы. Чтобы выбрать несколько файлов, нажмите Shift и щелкните файлы.

    3. На панели инструментов анализатора зависимостей, в разделе Impact Analysis, нажмите All Dependencies.

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

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

Пример использования проверок проекта для устранения проблем см. в разделах Преобразование из MDL в SLX в проекте и Сохранение истории ревизий.

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

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

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

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

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

    Следите за сообщениями в строке состояния, когда система контроля версий фиксирует ваши изменения. Git фиксирует в вашем локальном репозитории. Для фиксации удаленного репозитория используйте Push в разделе «Система контроля версий». Смотрите файлы Pull, Push и Fetch с Git

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

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

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

Кроме того, используйте project API, чтобы получить текущий проект:

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

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

Похожие примеры

Подробнее о