coder.updateBuildInfo

Обновите информационный объект сборки RTW.BuildInfo

свернуть все на странице

Синтаксис

coder.updateBuildInfo('addCompileFlags',options)

coder.updateBuildInfo('addLinkFlags',options)

coder.updateBuildInfo('addDefines',options)

coder.updateBuildInfo(___,group)

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)

Описание

пример

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

Вы видите добавленные параметры компилятора под вкладкой Build Logs в Отчете Генерации кода.

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

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

Запишите заголовочному файлу fact.h это объявляет функцию C factorial.
```
 double factorial(double x);
```
fact.h будет включен как заголовочный файл в сгенерированном коде. Это включение гарантирует, что функция объявляется, прежде чем она будет названа.
Сохраните файл в текущей папке.
Запишите файл C fact.c это содержит определение 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
```
В Отчете Генерации кода, на вкладке C Code, вы видите добавленный исходный файл fact.c.

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

Добавьте объект ссылки 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

Вы видите добавленный объект ссылки под вкладкой Build Logs в Отчете Генерации кода.

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

Добавьте включать путь к информации о сборке при генерации кода для функции, 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}
```
Откройте Отчет Генерации кода. Заголовочный файл adder.h включен в сгенерированный код.

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

свернуть все

`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 задает соответствующий файл, который будет добавлен к информации о сборке проекта.

Продвижение аргумента	Файл, заданный `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, этот аргумент проигнорирован.

Типы данных: логический

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

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

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

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

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

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

coder.updateBuildInfo

Синтаксис

Описание

Примеры

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

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

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

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

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

`options` — Создайте опции
вектор символов | строковый скаляр

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

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

`path` — Путь
вектор символов | строковый скаляр

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

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

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

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

Темы

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

Поддержка

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

coder.updateBuildInfo

Синтаксис

Описание

Примеры

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

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

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

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

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

options — Создайте опции вектор символов | строковый скаляр

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

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

path — Путь вектор символов | строковый скаляр

priority — Относительный приоритет объекта ссылки ' '

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

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

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

Темы

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

Поддержка

`options` — Создайте опции
вектор символов | строковый скаляр

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

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

`path` — Путь
вектор символов | строковый скаляр

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

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

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