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

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

sl_customization.m Файл

sl_customization.m файл может использоваться, чтобы зарегистрировать специфичные для установки функции рычага, которые будут вызваны во время процесса сборки. Функции рычага, которые вы регистрируете через sl_customization.m дополнительные рычаги Системного конечного файла (STF) (описанный в Настраивают Процесс сборки с Файлом 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
>>