Управление папками процесса построения

Процесс сборки помещает созданные файлы из обновлений схем Simulink ® и компонует модель в иерархию папок, заданную по умолчанию. Спецификацию по умолчанию для папок процесса построения можно изменить, например:

Компания не использует текущую рабочую папку в качестве расположения для папки создания кода или папки кэша моделирования.
Папка создания кода помещается под управление версиями, но папка кэша моделирования не помещается под управление версиями.

Параметры сеанса MATLAB ®CacheFolder, CodeGenFolder, и CodeGenFolderStructure - параметры управления созданием файлов, определяющие расположения папок для процесса построения. В начале сеанса MATLAB эти настройки Simulink определяют значения параметров:

Папка кэша моделирования - CacheFolder

Папка создания кода - CodeGenFolder

Структура папки генерации кода - CodeGenFolderStructure

Для изменения параметров во время сеанса MATLAB используйте Simulink.fileGenControl. Заданные значения параметров истекают в конце сеанса MATLAB.

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

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

Параметр сеанса MATLAB Предпочтения Simulink Описание

Параметр сеанса MATLAB	Предпочтения Simulink	Описание
`CacheFolder`	Папка кэша моделирования	Процесс построения размещает созданные файлы из обновлений диаграмм Simulink и артефактов построения модели для моделирования и создания кода в папке кэша моделирования `simulationCacheFolder`. Папка является корневой папкой. По умолчанию (`CacheFolder = ''`), `simulationCacheFolder` - текущая рабочая папка, `pwd`. С помощью параметра можно указать другую папку. Например, если необходимо: Отделите созданные файлы от моделей и других исходных материалов. Повторное использование или совместное использование ранее построенных целей моделирования без необходимости установки текущей рабочей папки обратно в предыдущую рабочую папку.
`CodeGenFolder`	Папка создания кода	В процессе построения, использующем целевые системные файлы для создания производственного кода из модели Simulink, производственный код помещается в папку создания кода. `codeGenerationFolder`. Папка является корневой папкой. При создании исполняемого файла программы процесс построения записывает файл. `model``.exe` (Windows ®) или`model` (UNIX ®) в папку. По умолчанию (`CodeGenFolder = ''`), `codeGenerationFolder` - текущая рабочая папка, `pwd`. С помощью параметра можно указать другую папку. Например, если требуется отделить созданный производственный код от: Модели и другие исходные материалы. Созданные артефакты моделирования и создания кода. Если в качестве папки создания кода указана корневая папка диска, процесс сборки не сможет создать код для модели. Например, `C:\`.
`CodeGenFolderStructure`	Структура папки генерации кода	Чтобы указать структуру папки в папке создания кода, используйте параметр. Например, при настройке моделей для различных целевых сред можно указать отдельную подпапку для сгенерированного кода из каждой модели.

CacheFolder

Папка кэша моделирования

Процесс построения размещает созданные файлы из обновлений диаграмм Simulink и артефактов построения модели для моделирования и создания кода в папке кэша моделирования simulationCacheFolder. Папка является корневой папкой.

По умолчанию (CacheFolder = ''), simulationCacheFolder - текущая рабочая папка, pwd.

С помощью параметра можно указать другую папку. Например, если необходимо:

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

CodeGenFolder

Папка создания кода

В процессе построения, использующем целевые системные файлы для создания производственного кода из модели Simulink, производственный код помещается в папку создания кода. codeGenerationFolder. Папка является корневой папкой.

При создании исполняемого файла программы процесс построения записывает файл. model.exe (Windows ®) илиmodel (UNIX ®) в папку.

По умолчанию (CodeGenFolder = ''), codeGenerationFolder - текущая рабочая папка, pwd.

С помощью параметра можно указать другую папку. Например, если требуется отделить созданный производственный код от:

Модели и другие исходные материалы.
Созданные артефакты моделирования и создания кода.

Если в качестве папки создания кода указана корневая папка диска, процесс сборки не сможет создать код для модели. Например, C:\.

CodeGenFolderStructure

Структура папки генерации кода

Чтобы указать структуру папки в папке создания кода, используйте параметр. Например, при настройке моделей для различных целевых сред можно указать отдельную подпапку для сгенерированного кода из каждой модели.

Папки процесса построения

Эта таблица содержит сведения о том, как CodeGenFolderStructure управляет структурой папки в папке кэша моделирования и папке создания кода.

Имя папки, когда `CodeGenFolderStructure` = `'ModelSpecific'`	Имя папки, когда `CodeGenFolderStructure` = `'TargetEnvironmentSubfolder'`	Описание
`codeGenerationFolder``/``model``_``target``_rtw` Значение по умолчанию для `target` - имя выбранного целевого системного файла, например, `grt`, `ert`, и `rsim`. Вы можете изменить `target` с `rtwgensettings.BuildDirSuffix` в целевом системном файле.	`codeGenerationFolder``/``targetSpecific``/``model` В процессе построения используется информация о конфигурации целевого файла системы и аппаратного устройства для создания уникальной метки для подпапки. `targetSpecific`.	Папка построения, в которой хранится созданный исходный код и другие файлы, созданные процессом построения. Содержит сгенерированные модули кода, `model``.c` и `model``.h`и сгенерированный make-файл, `model``.mk`. `model``.mk` предназначен для компиляции и связывания кода, сгенерированного из компонентов модели. `model` - имя исходной модели.
`codeGenerationFolder``/``model``_target_rtw/html`	`codeGenerationFolder``/``targetSpecific``/``model``/html`	Папка отчета о создании кода, содержащая файлы отчетов, созданные процессом построения.
`codeGenerationFolder``/slprj/``target``/``model`	`codeGenerationFolder``/``targetSpecific``/_ref/``model`	Целевые файлы ссылок на модель.
`codeGenerationFolder``/slprj/``target``/``model``/referenced_model_includes`	`codeGenerationFolder``/``targetSpecific``/_ref/``model``/referenced_model_includes`	Заголовочные файлы из моделей, на которые ссылается `model`.
`codeGenerationFolder``/slprj/``target``/``model``/tmwinternal`	`codeGenerationFolder``/``targetSpecific``/_ref/``model``/tmwinternal`	MAT-файлы, используемые при создании кода.
`codeGenerationFolder``/slprj/``target``/_sharedutils`	`codeGenerationFolder``/``targetSpecific``/_shared`	Функции утилиты для целевых файлов системы ссылок на модели, которые совместно используются в моделях. Папка также содержит `rtwshared.mk` для компиляции сгенерированного общего служебного кода
`simulationCacheFolder``/slprj/sim/``model`	`simulationCacheFolder``/slprj/sim/``model`	Целевые файлы моделирования для ссылочных моделей.
`simulationCacheFolder``/slprj/sim/``model``/``tmwinternal`	`simulationCacheFolder``/slprj/sim/``model``/``tmwinternal`	MAT-файлы, используемые при создании кода.
`simulationCacheFolder``/slprj/sim/_sharedutils`	`simulationCacheFolder``/slprj/sim/_sharedutils`	Функции утилиты для целевых файлов расчетной системы, которые совместно используются в моделях.

Если системный целевой файл основан на ERT, то эти параметры конфигурации модели также управляют расположением общего служебного кода:

Размещение совместно используемого кода (UtilityFuncGeneration)
Существующий общий код (ExistingSharedCode)

Вы можете использовать RTW.getBuildDir отображение информации о папке сборки для модели.

См. также

RTW.getBuildDir | Simulink.fileGenControl

Документация