coder.make.BuildTool class

Пакет: coder.make

Представляйте инструмент сборки

Описание

Используйте coder.make.BuildTool получить и задать существующий coder.make.BuildTool по умолчанию объект, или создать coder.make.BuildTool объект.

Работать с BuildTool по умолчанию объекты, используйте получать и задайте подход от ToolchainInfo свойства:

coder.make.ToolchainInfo.BuildTools
coder.make.ToolchainInfo.PostbuildTools

Примеры, показывающие получать и, задают подход:

Файл определения набора инструментальных средств с комментарием
Учебный пример: Добавление Пользовательского примера по Набору инструментальных средств

Альтернатива тому, чтобы получать и задает подход, создавание нового подхода. Пример, показывающий создавание нового подхода, появляется в, Создают BuildTool Не по умолчанию.

Рисунок показывает отношение между BuildTool по умолчанию объекты и ToolchainInfo. Когда вы исследуете PHONY TARGETS раздел сгенерированного make-файла, различия между BuildTools, PostbuildTools, и PrebuildTools становится более ясным.

prebuild – запуски только инструмент перед сборкой.
build – запускает инструменты сборки после рабочей предварительной сборки. build генерирует сборку PRODUCT.
postbuild – запускает инструмент постсборки после рабочей сборки.
all – предварительная сборка запусков, сборка и постсборка. Процесс сборки использует это правило на сборке Ctrl+B.
clean – очищает все расширения выходного файла и расширения производного файла всех инструментов в наборе инструментальных средств.
info – расширяет и распечатывает все макросы, используемые в make-файле.

Конструкция

h = coder.make.BuildTool(bldtl_name) создает coder.make.BuildTool объект и наборы его Name свойство.

Входные параметры

развернуть все

`bldtl_name` — Создайте имя инструмента
вектор символов | строковый скаляр

Создайте имя инструмента в виде вектора символов или строкового скаляра.

Типы данных: char | string

Выходные аргументы

развернуть все

`h` — Указатель на объект
переменная

Указатель на объект для coder.make.BuildTool объект в виде переменной.

Пример: tool

Свойства

развернуть все

`Command` — Создайте макрос команды или команды инструмента

Представляет использование команды инструмента сборки:

Дополнительное макро-имя, такое как: CC.
Системный вызов (команда), которая запускает инструмент сборки, такой как: gcc.

Макро-имя и системный вызов появляются вместе в сгенерированном make-файле. Например: CC = gcc

Присвоение значения к этому свойству является дополнительным.

Можно использовать следующие методы с Command:

Атрибуты:

`GetAccess`	`public`
`SetAccess`	`public`

`Directives` — Специфичные для инструмента директивы

Задает любые специфичные для инструмента директивы, такие как -D поскольку препроцессор задает. Присвоение значения к этому свойству является дополнительным.

Можно использовать следующие методы с Directives:

Атрибуты:

`GetAccess`	`public`
`SetAccess`	`public`

`FileExtensions` — Специфичные для инструмента расширения файла

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

Можно использовать следующие методы с FileExtensions:

Атрибуты:

`GetAccess`	`public`
`SetAccess`	`public`

`Name` — Имя инструмента сборки

Задает имя инструмента сборки.

Можно использовать следующие методы с Name.

Атрибуты:

`GetAccess`	`public`
`SetAccess`	`public`

`Path` — Специфичные для инструмента пути

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

Можно использовать следующие методы с Path:

Атрибуты:

`GetAccess`	`public`
`SetAccess`	`public`

`SupportedOutputs` — Специфичные для инструмента выходные форматы

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

Значением по умолчанию является {'*'}, который указывает на поддержку всех доступных форматов.

Тип данных является массивом ячеек. Содержимым массива ячеек должен быть любой coder.make.BuildOutput перечислимые величины или '*'.

Это свойство не имеет никаких связанных методов. Присвойте значение непосредственно SupportedOutputs. Смотрите addPrebuildToolToToolchainInfo.m пример или addPostbuildToolToToolchainInfo.m пример. Допустимые перечислимые величины:

`coder.make.BuildOutput.STATIC_LIBRARY`	запрашивает инструменты перед сборкой, инструменты сборки и инструменты пост-сборки
`coder.make.BuildOutput.SHARED_LIBRARY`	запрашивает инструменты сборки и инструменты пост-сборки; требует лицензии Embedded Coder^®
`coder.make.BuildOutput.EXECUTABLE`	запрашивает инструменты сборки и инструменты пост-сборки

Атрибуты:

`GetAccess`	`public`
`SetAccess`	`public`

Методы

addDirective	Добавьте директиву в `Directives`
addFileExtension	Добавьте новую запись расширения файла в `FileExtensions`
getCommand	Получите команду инструмента сборки
getDirective	Получите значение именованной директивы от `Directives`
getFileExtension	Получите расширение файла для именованного типа файла в `FileExtensions`
getName	Получите имя инструмента сборки
getPath	Получите путь и макрос инструмента сборки в `Path`
информация	Отобразите свойства инструмента сборки и значения
setCommand	Установите команду инструмента сборки
setCommandPattern	Установленный образец команд для инструментов сборки
setCompilerOptionMap	Установите язык C/C++ стандартные и параметры компилятора для выбранного инструмента сборки (компилятор)
setDirective	Установите значение директивы в `Directives`
setFileExtension	Установите расширение файла для именованного типа файла в `FileExtensions`
setName	Определите имя инструмента сборки
setPath	Установите путь и макрос инструмента сборки в `Path`
подтвердить	Подтвердите свойства инструмента сборки

Копировать семантику

Указатель. Чтобы узнать, как классы Handle влияют на операции копирования, см. раздел "Копирование объектов".

Пример

Получите инструмент сборки по умолчанию и набор его свойства
Создайте BuildTool Не по умолчанию
Добавьте предварительную сборку и инструменты пост-сборки к набору инструментальных средств

Получите инструмент сборки по умолчанию и набор его свойства

intel_tc.m файл от Добавления Пользовательского Набора инструментальных средств использует следующие линии, чтобы получить инструмент сборки по умолчанию, C Compiler, от ToolchainInfo возразите названному tc, и затем устанавливает его свойства.

% ------------------------------
% C Compiler
% ------------------------------
 
tool = tc.getBuildTool('C Compiler');

tool.setName('Intel C Compiler');
tool.setCommand('icl');
tool.setPath('');

tool.setDirective('IncludeSearchPath','-I');
tool.setDirective('PreprocessorDefine','-D');
tool.setDirective('OutputFlag','-Fo');
tool.setDirective('Debug','-Zi');

tool.setFileExtension('Source','.c');
tool.setFileExtension('Header','.h');
tool.setFileExtension('Object','.obj');

tool.setCommandPattern('|>TOOL<| |>TOOL_OPTIONS<| |>OUTPUT_FLAG<||>OUTPUT<|');

Следующие примеры показывают, что то же самое “получает и задает” подход более подробно:

Файл определения набора инструментальных средств с комментарием
Учебный пример: Добавление Пользовательского примера по Набору инструментальных средств

Создайте BuildTool Не по умолчанию

Создать инструмент сборки:

Создайте файл, который задает BuildTool объект, такой как createBuildTool_1.m или createBuildTool_2.
Создайте файл как addBuildToolToToolchainInfo.m, это:
- Создает ToolchainInfo объект или использование существующее.
- Создает BuildTool объект от createBuildTool_1.m или createBuildTool_2.
- Добавляет BuildTool возразите против ToolchainInfo объект.
Запустите addBuildToolToToolchainInfo.m.

Обратитесь к следующим примерам addBuildToolToToolchainInfo.m, createBuildTool_1.m, и createBuildTool_2.m.

addBuildToolToToolchainInfo.m

createBuildTool_1.m

function buildToolObj = createBuildTool_1()

toolinfo.Name                       = 'My GNU C Compiler';
toolinfo.Language                   = 'C';

toolinfo.Command.Macro              = 'CC';
toolinfo.Command.Value              = 'gcc';

toolinfo.Path.Macro                 = 'CC_PATH';
toolinfo.Path.Value                 = '';

toolinfo.OptionsRegistry            = {'My C Compiler','MY_CFLAGS'};

% Key name of this directive
toolinfo.Directives(1).Key          = 'IncludeSearchPath';

% Macro of this directive (directives can have empty macros)
toolinfo.Directives(1).Macro        = '';                   

% Value of this directive
toolinfo.Directives(1).Value        = '-I';                 

toolinfo.Directives(2).Key          = 'PreprocessorDefine';
toolinfo.Directives(2).Macro        = '';
toolinfo.Directives(2).Value        = '-D';

toolinfo.Directives(3).Key          = 'Debug';
toolinfo.Directives(3).Macro        = 'CDEBUG';
toolinfo.Directives(3).Value        = '-g';

toolinfo.Directives(4).Key          = 'OutputFlag';
toolinfo.Directives(4).Macro        = 'C_OUTPUT_FLAG';
toolinfo.Directives(4).Value        = '-o';

% Key name of this file extension
toolinfo.FileExtensions(1).Key      = 'Source';  

% Macro of this file extension
toolinfo.FileExtensions(1).Macro    = 'C_EXT';   

% Value of this file extension
toolinfo.FileExtensions(1).Value    = '.c';      

toolinfo.FileExtensions(2).Key      = 'Header';
toolinfo.FileExtensions(2).Macro    = 'H_EXT';
toolinfo.FileExtensions(2).Value    = '.h';

toolinfo.FileExtensions(3).Key      = 'Object';
toolinfo.FileExtensions(3).Macro    = 'OBJ_EXT';
toolinfo.FileExtensions(3).Value    = '.obj';

toolinfo.DerivedFileExtensions      = {'$(OBJ_EXT)'};
% '*' means all outputs are supported
toolinfo.SupportedOutputs           = {'*'}; 


% put actual extension (e.g. '.c') or keyname if already registered
% under 'FileExtensions'
toolinfo.InputFileExtensions        = {'Source'}; 
toolinfo.OutputFileExtensions       = {'Object'}; 

% Create a build tool object and populate it with the above data
buildToolObj = createAndpopulateBuildTool(toolinfo);

function buildToolObj = createAndpopulateBuildTool(toolinfo)

% -------------------------
% Construct a BuildTool
% -------------------------
buildToolObj = coder.make.BuildTool();

% -------------------------
% Set general properties
% -------------------------
buildToolObj.Name              = toolinfo.Name;
buildToolObj.Language          = toolinfo.Language;
buildToolObj.Command           = coder.make.BuildItem ...
    (toolinfo.Command.Macro,toolinfo.Command.Value);
buildToolObj.Path              = coder.make.BuildItem ...
    (toolinfo.Path.Macro,toolinfo.Path.Value);
buildToolObj.OptionsRegistry   = toolinfo.OptionsRegistry;
buildToolObj.SupportedOutputs  = toolinfo.SupportedOutputs;

% -------------------------
% Directives
% -------------------------
for i = 1:numel(toolinfo.Directives)
    directiveBuildItem = coder.make.BuildItem(...
        toolinfo.Directives(i).Macro,toolinfo.Directives(i).Value);
    buildToolObj.addDirective(toolinfo.Directives(i).Key,directiveBuildItem);
end

% -------------------------
% File extensions
% -------------------------
for i = 1:numel(toolinfo.FileExtensions)
    fileExtBuildItem = coder.make.BuildItem(...
        toolinfo.FileExtensions(i).Macro,toolinfo.FileExtensions(i).Value);
    buildToolObj.addFileExtension(toolinfo.FileExtensions(i).Key,fileExtBuildItem);
end

% -------------------------
% Derived file extensions
% -------------------------
for i = 1:numel(toolinfo.DerivedFileExtensions)
    if buildToolObj.FileExtensions.isKey(toolinfo.DerivedFileExtensions{i})
        buildToolObj.DerivedFileExtensions{end+1} = ...
        ['$(' buildToolObj.getFileExtension
        (toolinfo.DerivedFileExtensions{i}) ')'];
    else
        buildToolObj.DerivedFileExtensions{end+1} = toolinfo.DerivedFileExtensions{i};
    end
end

% -------------------------
% Command pattern
% -------------------------
if isfield(toolinfo,'CommandPattern')
    buildToolObj.CommandPattern = toolinfo.CommandPattern;
end

% --------------------------------
% [Input/Output]FileExtensions
% --------------------------------
if isfield(toolinfo,'InputFileExtensions')
    buildToolObj.InputFileExtensions = toolinfo.InputFileExtensions;
end
if isfield(toolinfo,'OutputFileExtensions')
    buildToolObj.OutputFileExtensions = toolinfo.OutputFileExtensions;
end

createBuildTool_2.m

function buildToolObj = createBuildTool_2()

% -------------------------
% Construct a BuildTool
% -------------------------
buildToolObj = coder.make.BuildTool();

% -------------------------
% Set general properties
% -------------------------
buildToolObj.Name               = 'My GNU C Compiler';
buildToolObj.Language           = 'C';
buildToolObj.Command            = coder.make.BuildItem('CC','gcc');
buildToolObj.Path               = coder.make.BuildItem('CC_PATH','');
buildToolObj.OptionsRegistry    = {'My C Compiler','MY_CFLAGS'};
buildToolObj.SupportedOutputs   = {'*'}; % '*' means all outputs are supported

% -------------------------
% Directives
% -------------------------

directiveBuildItem = coder.make.BuildItem('','-I');
buildToolObj.addDirective('IncludeSearchPath',directiveBuildItem);

directiveBuildItem = coder.make.BuildItem('','-D');
buildToolObj.addDirective('PreprocessorDefine',directiveBuildItem);

directiveBuildItem = coder.make.BuildItem('CDEBUG','-g');
buildToolObj.addDirective('Debug',directiveBuildItem);

directiveBuildItem = coder.make.BuildItem('C_OUTPUT_FLAG','-o');
buildToolObj.addDirective('OutputFlag',directiveBuildItem);

% -------------------------
% File Extensions
% -------------------------

fileExtBuildItem = coder.make.BuildItem('C_EXT','.c');
buildToolObj.addFileExtension('Source',fileExtBuildItem);

fileExtBuildItem = coder.make.BuildItem('H_EXT','.h');
buildToolObj.addFileExtension('Header',fileExtBuildItem);

fileExtBuildItem = coder.make.BuildItem('OBJ_EXT','.obj');
buildToolObj.addFileExtension('Object',fileExtBuildItem);

% -------------------------
% Others
% -------------------------

buildToolObj.DerivedFileExtensions  = {'$(OBJ_EXT)'};
buildToolObj.InputFileExtensions    = {'Source'};
% put actual extension (e.g. '.c')
% or keyname if already registered under 'FileExtensions'
buildToolObj.OutputFileExtensions   = {'Object'};
% put actual extension (e.g. '.c')
% or keyname if already registered under 'FileExtensions'

Добавьте предварительную сборку и инструменты пост-сборки к набору инструментальных средств

Код в addPrebuildToolToToolchainInfo.m и addPostbuildToolToToolchainInfo.m примеры показывают, как добавить предварительную сборку и инструменты пост-сборки к набору инструментальных средств.

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

coder.make.BuildTool class

Описание

Конструкция

Входные параметры

`bldtl_name` — Создайте имя инструмента
вектор символов | строковый скаляр

Выходные аргументы

`h` — Указатель на объект
переменная

Свойства

`Command` — Создайте макрос команды или команды инструмента

`Directives` — Специфичные для инструмента директивы

`FileExtensions` — Специфичные для инструмента расширения файла

`Name` — Имя инструмента сборки

`Path` — Специфичные для инструмента пути

`SupportedOutputs` — Специфичные для инструмента выходные форматы

Методы

Копировать семантику

Пример

Получите инструмент сборки по умолчанию и набор его свойства

Создайте BuildTool Не по умолчанию

Добавьте предварительную сборку и инструменты пост-сборки к набору инструментальных средств

Смотрите также

Темы

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

Поддержка

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

coder.make.BuildTool class

Описание

Конструкция

Входные параметры

bldtl_name — Создайте имя инструмента вектор символов | строковый скаляр

Выходные аргументы

h — Указатель на объект переменная

Свойства

Command — Создайте макрос команды или команды инструмента

Directives — Специфичные для инструмента директивы

FileExtensions — Специфичные для инструмента расширения файла

Name — Имя инструмента сборки

Path — Специфичные для инструмента пути

SupportedOutputs — Специфичные для инструмента выходные форматы

Методы

Копировать семантику

Пример

Получите инструмент сборки по умолчанию и набор его свойства

Создайте BuildTool Не по умолчанию

Добавьте предварительную сборку и инструменты пост-сборки к набору инструментальных средств

Смотрите также

Темы

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

Поддержка

`bldtl_name` — Создайте имя инструмента
вектор символов | строковый скаляр

`h` — Указатель на объект
переменная

`Command` — Создайте макрос команды или команды инструмента

`Directives` — Специфичные для инструмента директивы

`FileExtensions` — Специфичные для инструмента расширения файла

`Name` — Имя инструмента сборки

`Path` — Специфичные для инструмента пути

`SupportedOutputs` — Специфичные для инструмента выходные форматы