Настройте Процесс сборки с sl_customization.m

sl_customization.m файла настройки Simulink® является механизмом, который позволяет вам использовать MATLAB®, чтобы настроить интерфейс процесса сборки. Программное обеспечение Simulink читает файл sl_customization.m, если существующий на пути MATLAB, когда это запускается и индивидуальные настройки, заданные в файле, применяются к сеансу Simulink. Для получения дополнительной информации о файле настройки sl_customization.m смотрите Индивидуальные настройки Регистрации (Simulink).

sl_customization.m Файл

Файл sl_customization.m может использоваться, чтобы зарегистрировать специфичные для установки функции рычага, которые будут вызваны во время процесса сборки. Функции рычага, которые вы регистрируете через рычаги Системного конечного файла (STF) дополнения sl_customization.m (описанный в Настраивают Процесс сборки с Файлом STF_make_rtw_hook), и команды генерации почтового индекса (описанный в Настраивают Обработку Сборки Постгенерации кода).

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

Зарегистрируйте Функции Рычага Процесса сборки Используя sl_customization.m

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

function sl_customization(cm)

Как отправная точка для ваших индивидуальных настроек, функция sl_customization должна сначала получить значение по умолчанию (фабрика) индивидуальные настройки, с помощью следующего оператора присваивания:

hObj = cm.RTWBuildCustomizer;

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

  • addUserHook(hObj, hookType, hook)

    Указывает скрипт рычага MATLAB или функцию, заданную hook для этапа процесса сборки, представленного hookType. Допустимыми значениями для hookType является 'entry', 'before_tlc', 'after_tlc', 'before_make', 'after_make' и 'exit'.

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

Программное обеспечение Simulink читает файл sl_customization.m, когда это запускается. Если вы впоследствии изменяете файл, необходимо перезапустить сеанс Simulink или ввести следующую команду в Командном окне, чтобы включить изменения:

sl_refresh_customizations

Переменные, Доступные для Функций Рычага sl_customization.m

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

  • modelName — Имя модели Simulink (допустимый для всех этапов)

  • dependencyObject — Объект, содержащий зависимости сгенерированного кода (допустимый только для этапа 'after_make')

Скрипт рычага может непосредственно получить доступ к действительным переменным. Функция рычага может передать действительные переменные в качестве аргументов к функции. Например:

hObj.addUserHook('after_make', 'afterMakeFunction(modelName,dependencyObject);');

Пример Индивидуальной настройки Процесса сборки с sl_customization.m

Файл sl_customization.m, показанный в примере, sl_customization.m для Индивидуальных настроек Процесса сборки, использует метод addUserHook, чтобы задать специфичные для установки рычаги процесса сборки, которые будут вызваны в 'entry' и этапах 'after_tlc' процесса сборки. Для исходного кода функции рычага смотрите CustomRTWEntryHook.m и примеры CustomRTWPostProcessHook.m.

 Пример 1. sl_customization.m для Индивидуальных настроек Процесса сборки
function sl_customization(cm)
% Register user customizations

% Get default (factory) customizations
hObj = cm.RTWBuildCustomizer;

% Register build process hooks
hObj.addUserHook('entry', 'CustomRTWEntryHook(modelName);');
hObj.addUserHook('after_tlc', 'CustomRTWPostProcessHook(modelName);');

end
 Пример 2. CustomRTWEntryHook.m
function [str, status] = CustomRTWEntryHook(modelName)
str =sprintf('Custom entry hook for model ''%s.''',modelName);
disp(str)
status =1;
 Пример 3. CustomRTWPostProcessHook.m
function [str, status] = CustomRTWPostProcessHook(modelName)
str =sprintf('Custom post process hook for model ''%s.''',modelName);
disp(str)
status =1;

Если вы включаете вышеупомянутые три файла на пути MATLAB установки Simulink, которую вы хотите настроить, закодированные сообщения функции рычага появляются в отображенном выводе для сборок. Например, если вы открываете основанную на ERT модель rtwdemo_udt, открываете панель Code Generation диалогового окна Configuration Parameters и нажимаете Ctrl+B, чтобы инициировать сборку, следующие сообщения отображены:

>> rtwdemo_udt

### Starting build procedure for model: rtwdemo_udt
Custom entry hook for model 'rtwdemo_udt.'
Custom post process hook for model 'rtwdemo_udt.'
### Successful completion of build procedure for model: rtwdemo_udt
>>