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

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

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

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

Simulation cache folder (Simulink) – CacheFolder

Code generation folder (Simulink) – CodeGenFolder

Code generation folder structure (Simulink) – CodeGenFolderStructure

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

Параметры управления генерацией файла

Эта таблица предоставляет информацию о том, как можно использовать параметры, чтобы управлять папками процесса сборки.

Параметр сеанса работы с MATLAB Настройка Simulink Описание

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

CacheFolder

Simulation cache folder (Simulink)

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

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

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

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

CodeGenFolder

Code generation folder (Simulink)

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

Если вы принимаете решение сгенерировать файл исполняемой программы, процесс сборки записывает файл model .exe (Windows^®) или model (UNIX^®) к папке.

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

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

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

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

CodeGenFolderStructure

Code generation folder structure (Simulink)

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

Папки процесса сборки

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

Имя папки, когда `CodeGenFolderStructure` = `'ModelSpecific'`	Имя папки, когда `CodeGenFolderStructure` = `'TargetEnvironmentSubfolder'`	Описание
`codeGenerationFolder` `/` `model` `_` `target` `_rtw` Значением по умолчанию для `target` является имя выбранного системного конечного файла, например, `grt`, `ert` и `rsim`. Можно изменить `target` с the `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, то эти параметры конфигурации также управляют местоположением разделяемого служебного кода:

Разделяемое размещение кода (Simulink Coder) (UtilityFuncGeneration)
Существующий разделяемый код (ExistingSharedCode)

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

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