Генератор кода предоставляет набор инструментов, включая информационный объект построения, который можно использовать для настройки обработки построения, которая происходит после создания кода. Такие настройки можно использовать для целевой разработки или интеграции сторонних инструментов в среду разработки приложений.
На следующем рисунке и последующих шагах показан общий рабочий процесс настройки посткодовых настроек.
Подавление создания makefile, если применимо.
Создайте модель.
Измените команду и перестраивайте модель до тех пор, пока результаты построения не станут приемлемыми.
В начале построения модели процесс построения регистрирует следующую опцию построения и информацию о зависимостях во временном информационном объекте построения.
Параметры компилятора
Определения идентификаторов препроцессора
Варианты компоновщика
Исходные файлы и пути
Включить файлы и пути
Предварительно скомпилированные внешние библиотеки
Можно извлекать информацию из этого объекта и добавлять ее к нему с помощью широкого набора функций. Список доступных функций и подробные описания функций см. в разделе Настройка процесса построения. Программирование команды генерации посткодов объясняет, как использовать функции для управления обработкой создания посткодов.
Для некоторых приложений можно управлять аспектами процесса сборки после создания кода. Например, этот подход можно использовать при разработке собственного целевого объекта или при необходимости применения инструмента анализа к сгенерированному коду перед продолжением процесса построения. Этот уровень управления можно применить к процессу построения путем программирования и последующего определения команды генерации посткодов.
Команда создания посткодов - это файл языка MATLAB ®, который обычно вызывает функции, получающие данные из или добавляющие данные в информационный объект построения модели. Команду можно запрограммировать как сценарий или функцию.
| Если команда запрограммирована как: | Затем: |
|---|---|
| Сценарий | Скрипт может получить доступ к имени модели и информации о построении непосредственно |
| Функция | Функция может передавать имя модели и сведения о построении в качестве аргументов |
Если команда создания почтового кода вызывает пользовательские функции, убедитесь, что они находятся в пути MATLAB. Если процессу построения не удается найти функцию, используемую в команде, процесс построения выдает ошибку.
Затем можно вызвать комбинацию информационных функций построения, перечисленных в разделе Настройка процесса построения, для настройки обработки создания посткодов модели.
В следующем примере показан фрагмент команды создания посткодов, который получает имена файлов и пути источника и включает файлы, созданные для модели для анализа.
function analyzegencode(buildInfo)
% Get the names and paths of source and include files
% generated for the model and then analyze them.
% buildInfo - build information for my model.
% Define cell array to hold data.
MyBuildInfo={};
% Get source file information.
MyBuildInfo.srcfiles=getSourceFiles(buildInfo, true, true);
MyBuildInfo.srcpaths=getSourcePaths(buildInfo, true);
% Get include (header) file information.
MyBuildInfo.incfiles=getIncludeFiles(buildInfo, true, true);
MyBuildInfo.incpaths=getIncludePaths(buildInfo, true);
% Analyze generated code.
.
.
.После программирования команды генерации посткодов сообщите процессу сборки, что команда существует, и добавьте ее к обработке сборки модели. Определите команду с помощью PostCodeGenCommand параметр конфигурации модели. При определении команды создания посткодов процесс сборки оценивает команду после создания и записи сгенерированного кода на диск и перед созданием make-файла.
Как показывают следующие строки синтаксиса, аргументы, задаваемые при установке параметра конфигурации, зависят от того, запрограммирована ли команда как сценарий, функция или набор функций.
Примечание
При определении команды как функции можно задать произвольное число входных аргументов. Чтобы передать функции имя и информацию о построении модели, укажите идентификаторы modelName и buildInfo в качестве аргументов.
Сценарий
set_param(model, 'PostCodeGenCommand',... 'pcgScriptName');
Функция
set_param(model, 'PostCodeGenCommand',... 'pcgFunctionName(modelName)');
Несколько функций
pcgFunctions=... 'pcgFunction1Name(modelName);... pcgFunction2Name(buildInfo)'; set_param(model, 'PostCodeGenCommand',... pcgFunctions);
Следующий вызов set_param определяет PostCodGenCommand для оценки функции analyzegencode.
set_param(model, 'PostCodeGenCommand',... 'analyzegencode(buildInfo)');
В этом примере показано, как использовать интерфейс программирования информации построения и параметр конфигурации модели Post code generation command (команда генерации посткодов) (PostCodeGenCommand) для настройки процесса построения. В этом примере для команды создания кода Post установлено значение rtwdemo_buildinfo_data. Процесс построения вызывает эту функцию после создания кода.
В примере также показано, как использовать функцию конфигурации построения rtwmakecfg.m.
Открыть пример модели
Открыть пример модели rtwdemo_buildinfo.
open_system('rtwdemo_buildinfo');
Создать код из модели
Создать код. Генератор кода создает файл BuildInfo.html, который документирует информационный объект построения.
Анализ настроек и выходных данных процесса построения
Проверьте настройки процесса построения и запрос создания посткодов информационного объекта построения. В веб-браузере откройте файл BuildInfo.html. Файл содержит гиперссылки, которые можно использовать для проверки кода, созданного для модели. Либо в окне команды MATLAB:
Для просмотра функции, сконфигурированной для выполнения на этапе создания посткодов процесса построения, введите:
get_param('rtwdemo_buildinfo','PostCodeGenCommand');
Для изучения интерфейса программирования для информационного объекта построения введите:
rtwdemo_buildinfo_data(buildInfo);
Чтобы изучить, как в примере используется rtwmakecfg функция, введите:
edit rtwmakecfg.m;
Просмотр данных объекта информации построения, сохраненных процессом построения в buildInfo.mat файл, откройте файл rtwdemo_<target>_rtw\buildInfo.mat.
Просмотр содержимого функции создания кода проводки rtwdemo_buildinfo_data.m, введите:
edit rtwdemo_buildinfo_data.m;
В конце файла функция вызывает packNGo для упаковки исходных файлов и файлов объектов, идентифицируемых объектом информации построения для перемещения.
Связанные темы
Генератор кода позволяет подавлять создание makefile во время процесса построения. Например, эту поддержку можно использовать при интеграции в процесс сборки инструментов, не использующих make-файлы.
Чтобы дать генератору кода команду не создавать make-файл, выполните одно из следующих действий:
Снимите флажок Генерировать makefile на панели Создание кода (Code Generation) диалогового окна Параметры конфигурации (Configuration Parameters).
Установка значения параметра конфигурации GenerateMakefile кому off.
При подавлении генерации makefile
Невозможно явно указать make-файл команды создания или шаблона.
Укажите собственные инструкции по обработке генерации почтового кода, включая компиляцию и связывание, в команде генерации почтового кода, как описано в разделе Программа, Команда генерации почтового кода и Определение команды генерации почтового кода.