coder.updateBuildInfo

Обновить объект сведений о построении RTW.BuildInfo

Синтаксис

coder.updateBuildInfo (addCompaseFlags, параметры)

coder.updateBuildInfo (addLinkFlags, параметры)

coder.updateBuildInfo ('addDefines', параметры)

coder.updateBuildInfo (___, группа)

coder.updateBuildInfo (addLinkObjects, имя файла, путь)

coder.updateBuildInfo (addLinkObjects, имя файла, путь, приоритет, предварительно скомпилированный)

coder.updateBuildInfo (addLinkObjects, имя файла, путь, приоритет, предварительно скомпилированный, linkonly)

coder.updateBuildInfo (___, группа)

coder.updateBuildInfo («addNonBuildFiles», имя файла)

coder.updateBuildInfo ('addSourceFiles', имя файла)

coder.updateBuildInfo («addIncludeFiles», имя файла)

coder.updateBuildInfo (___, путь)

coder.updateBuildInfo (___, путь, группа)

coder.updateBuildInfo (addSourcePaths, путь)

coder.updateBuildInfo (addIncludePaths, путь)

coder.updateBuildInfo (___, группа)

Описание

пример

coder.updateBuildInfo('addCompileFlags',options) добавляет параметры компилятора в информационный объект построения.

coder.updateBuildInfo('addLinkFlags',options) добавляет параметры связи в информационный объект построения.

coder.updateBuildInfo('addDefines',options) добавляет определения макросов препроцессора в информационный объект построения.

coder.updateBuildInfo(___,group) присваивает имя группы options для более поздних ссылок.

пример

coder.updateBuildInfo('addLinkObjects',filename,path) добавляет объект ссылки из файла в информационный объект построения.

coder.updateBuildInfo('addLinkObjects',filename,path,priority,precompiled) указывает, выполняется ли предварительная компиляция объекта связи.

coder.updateBuildInfo('addLinkObjects',filename,path,priority,precompiled,linkonly) указывает, должен ли объект быть построен до того, как он будет связан или использован только для связывания. Если объект должен быть построен, он определяет, будет ли объект предварительно скомпилирован.

coder.updateBuildInfo(___,group) назначает имя группы объекту связи для последующей ссылки.

coder.updateBuildInfo('addNonBuildFiles',filename) добавляет файл, не связанный со сборкой, в информационный объект построения.

пример

coder.updateBuildInfo('addSourceFiles',filename) добавляет исходный файл в информационный объект построения.

coder.updateBuildInfo('addIncludeFiles',filename) добавляет файл включения в информационный объект построения.

coder.updateBuildInfo(___,path) добавляет файл по указанному пути.

coder.updateBuildInfo(___,path,group) назначает имя группы файлу для последующей ссылки.

coder.updateBuildInfo('addSourcePaths',path) добавляет путь к исходному файлу в информационный объект построения.

пример

coder.updateBuildInfo('addIncludePaths',path) добавляет путь к файлу включения в информационный объект построения.

coder.updateBuildInfo(___,group) назначает имя группы пути для последующей ссылки.

Примеры

свернуть все

Добавить несколько параметров компилятора

Добавление параметров компилятора -Zi и -Wall при формировании кода для функции, func.

В любом месте кода MATLAB ® дляfunc, добавьте следующую строку:

coder.updateBuildInfo('addCompileFlags','-Zi -Wall');

Создать код для func с использованием codegen команда. Откройте отчет по созданию кода.

codegen -config:lib -launchreport func

Добавить имя исходного файла

Добавление исходного файла в информацию о построении проекта при создании кода для функции. calc_factorial.

Запись файла заголовка fact.h которая объявляет функцию C factorial.
```
 double factorial(double x);
```
fact.h будет включен в качестве файла заголовка в сгенерированный код. Это включение обеспечивает объявление функции перед ее вызовом.
Сохраните файл в текущей папке.

Запись файла C fact.c который содержит определение factorial. factorial вычисляет факториал его ввода.

#include "fact.h"
      
      double factorial(double x)
      {
          int i;
          double fact = 1.0;
          if (x == 0 || x == 1) {
             return 1.0;
         } else {
             for (i = 1; i <= x; i++) {
                 fact *= (double)i;
             }
             return fact;
         }
     }

fact.c используется в качестве исходного файла при создании кода.

Сохраните файл в текущей папке.

Запись функции MATLAB calc_factorial который использует coder.ceval для вызова внешней функции C factorial.
Использовать coder.updateBuildInfo с опцией 'addSourceFiles' для добавления исходного файла fact.c к информации о построении. Использовать coder.cinclude для включения файла заголовка fact.h в созданном коде.
```
function y = calc_factorial(x) %#codegen

  coder.cinclude('fact.h');
  coder.updateBuildInfo('addSourceFiles', 'fact.c');

  y = 0;
  y = coder.ceval('factorial', x);
```
Создать код для calc_factorial с использованием codegen команда.
```
 codegen -config:dll -launchreport calc_factorial -args 0
```

Добавить объект ссылки

Добавление объекта ссылки LinkObj.lib к информации построения при создании кода для функции func. Для этого примера необходимо иметь объект ссылки LinkObj.lib сохранен в локальной папке, например, c:\Link_Objects.

В любом месте кода MATLAB для func, добавьте следующие строки:

libPriority = '';
libPreCompiled = true;
libLinkOnly = true;
libName = 'LinkObj.lib';
libPath = 'c:\Link_Objects';
coder.updateBuildInfo('addLinkObjects', libName, libPath, ...
     libPriority, libPreCompiled, libLinkOnly);

Создание функции MEX для func с использованием codegen команда. Откройте отчет по созданию кода.

codegen -launchreport func

Добавить пути включения

Добавьте путь включения к информации построения при создании кода для функции, adder. Включить файл заголовка, adder.h, существующий на пути.

Если файлы заголовков не находятся в текущей папке, для их включения используйте следующий метод:

Запись файла заголовка mysum.h который содержит объявление для функции C mysum.
```
double mysum(double, double);
```
Сохраните его, например, в локальной папке c:\coder\myheaders.
Запись файла C mysum.c который содержит определение функции mysum.
```
#include "mysum.h"

double mysum(double x, double y)
 { 
  return(x+y);
 }
 
```
Сохраните его в текущей папке.

Запись функции MATLAB adder который добавляет путь c:\coder\myheaders к информации о построении.

Использовать coder.cinclude для включения файла заголовка mysum.h в созданном коде.

function y = adder(x1, x2) %#codegen
   coder.updateBuildInfo('addIncludePaths','c:\coder\myheaders');
   coder.updateBuildInfo('addSourceFiles','mysum.c'); 
     %Include the source file containing C function definition
   coder.cinclude('mysum.h');
   y = 0;
   if coder.target('MATLAB')
      % This line ensures that the function works in MATLAB 
        y = x1 + x2;
   else
       y = coder.ceval('mysum', x1, x2);
    end
end

Создать код для adder с использованием codegen команда.
```
codegen -config:lib -launchreport adder -args {0,0}
```

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

свернуть все

`options` - Параметры построения
вектор символов | строковый скаляр

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

В зависимости от ведущего аргумента, options указывает соответствующие параметры построения, добавляемые к информации о построении проекта.

Ведущий аргумент	Значения в `options`
`'addCompileFlags'`	Параметры компилятора
`'addLinkFlags'`	Параметры связи
`'addDefines'`	Определения макросов препроцессора

Функция добавляет опции в конец вектора опций.

Пример: coder.updateBuildInfo('addCompileFlags','-Zi -Wall')

`group` - Название группы
вектор символов | строковый скаляр

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

group присваивает имя группы параметрам во втором аргументе.

Ведущий аргумент	Второй аргумент	Параметры, именованные `group`
`'addCompileFlags'`	`options`	Параметры компилятора
`'addLinkFlags'`	`options`	Параметры связи
`'addLinkObjects'`	`filename`	Имя файла, содержащего связанные объекты
`'addNonBuildFiles'`	`filename`	Имя файла, не связанного со сборкой
`'addSourceFiles'`	`filename`	Имя исходного файла
`'addSourcePaths'`	`path`	Имя пути к исходному файлу

Вы можете использовать group кому:

Документирование использования определенных параметров.
Извлеките или примените несколько параметров вместе как одну группу.

`filename` - Имя файла
вектор символов | строковый скаляр

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

В зависимости от ведущего аргумента, filename указывает соответствующий файл, добавляемый в информацию о построении проекта.

Ведущий аргумент	Файл, указанный `filename`
`'addLinkObjects'`	Файл, содержащий связанные объекты
`'addNonBuildFiles'`	Неподстроенный файл
`'addSourceFiles'`	Исходный файл

Функция добавляет имя файла в конец вектора имени файла.

Пример: coder.updateBuildInfo('addSourceFiles', 'fact.c')

`path` - Имя пути
вектор символов | строковый скаляр

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

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

Ведущий аргумент	Путь, указанный `path`
`'addLinkObjects'`	Путь к связываемым объектам
`'addNonBuildFiles'`	Путь к файлам, не связанным со сборкой
`'addSourceFiles'`, `'addSourcePaths'`	Путь к исходным файлам

Относительный путь начинается с текущей рабочей папки, в которой создается код. В имени относительного пути укажите ссылку на текущую рабочую папку с помощью START_DIR макро. Например, предположим, что исходный файл fact.c содержится в C:\myCode\mySrcDir, и вы генерируете код из C:\myCode. Запишите путь, как в этом примере:

Пример: coder.updateBuildInfo('addSourceFiles','fact.c','$(START_DIR)\mySrcDir')

`priority` - Относительный приоритет объекта связи
' '

Приоритет объектов связи.

Эта функция применяется только при добавлении нескольких объектов связи. В настоящее время только один файл объекта ссылки может быть добавлен для каждого coder.updateBuildInfo заявление. Поэтому эта функция недоступна для использования.

Чтобы использовать последующие аргументы, включите '' в качестве аргумента-заполнителя.

`precompiled` - Переменная, указывающая, являются ли объекты связи предварительно скомпилированными
логическое значение

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

Если объект ссылки был предварительно построен для более быстрой компиляции и связывания и существует в указанном расположении, укажите true. В противном случае процесс построения MATLAB Coder™ создает объект связи в папке построения.

Если linkonly имеет значение true, этот аргумент игнорируется.

Типы данных: logical

`linkonly` - Переменная, указывающая, должны ли объекты использоваться только для связывания
логическое значение

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

Если требуется, чтобы процесс построения кодера MATLAB не создавал правила в make-файле для построения указанного объекта связи, укажите true. Вместо этого при связывании конечного исполняемого файла процесс должен просто включать объект. В противном случае правила построения объекта ссылки добавляются в make-файл.

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

Если linkonly имеет значение true, значение precompiled игнорируется.

Типы данных: logical

См. также

Темы

Представлен в R2013b

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

coder.updateBuildInfo

Синтаксис

Описание

Примеры

Добавить несколько параметров компилятора

Добавить имя исходного файла

Добавить объект ссылки

Добавить пути включения

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

`options` - Параметры построения
вектор символов | строковый скаляр

`group` - Название группы
вектор символов | строковый скаляр

`filename` - Имя файла
вектор символов | строковый скаляр

`path` - Имя пути
вектор символов | строковый скаляр

`priority` - Относительный приоритет объекта связи
' '

`precompiled` - Переменная, указывающая, являются ли объекты связи предварительно скомпилированными
логическое значение

`linkonly` - Переменная, указывающая, должны ли объекты использоваться только для связывания
логическое значение

См. также

Темы

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

Поддержка

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

coder.updateBuildInfo

Синтаксис

Описание

Примеры

Добавить несколько параметров компилятора

Добавить имя исходного файла

Добавить объект ссылки

Добавить пути включения

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

options - Параметры построения вектор символов | строковый скаляр

group - Название группы вектор символов | строковый скаляр

filename - Имя файла вектор символов | строковый скаляр

path - Имя пути вектор символов | строковый скаляр

priority - Относительный приоритет объекта связи ' '

precompiled - Переменная, указывающая, являются ли объекты связи предварительно скомпилированными логическое значение

linkonly - Переменная, указывающая, должны ли объекты использоваться только для связывания логическое значение

См. также

Темы

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

Поддержка

`options` - Параметры построения
вектор символов | строковый скаляр

`group` - Название группы
вектор символов | строковый скаляр

`filename` - Имя файла
вектор символов | строковый скаляр

`path` - Имя пути
вектор символов | строковый скаляр

`priority` - Относительный приоритет объекта связи
' '

`precompiled` - Переменная, указывающая, являются ли объекты связи предварительно скомпилированными
логическое значение

`linkonly` - Переменная, указывающая, должны ли объекты использоваться только для связывания
логическое значение