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

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

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

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

Simulation cache folder – CacheFolder

Code generation folder – CodeGenFolder

Code generation folder structure – CodeGenFolderStructure

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

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

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

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

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

CacheFolder

Simulation cache folder

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

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

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

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

CodeGenFolder

Code generation folder

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

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

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

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

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

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

CodeGenFolderStructure

Code generation folder structure

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

Создание папок процессов

В этой таблице приведены сведения о том, как 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)
Существующий общий код (Embedded Coder) (ExistingSharedCode)

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

См. также

RTW.getBuildDir | Simulink.fileGenControl

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