codebuild

编译和链接生成的代码

自 R2020b 起

全页折叠

语法

buildResults = codebuild(buildFolder)

codebuild(buildFolder, Name,Value)

codebuild(buildInfo, Name,Value)

说明

示例

buildResults = codebuild(buildFolder) 从 buildFolder 中的 buildInfo.mat 文件加载数据，在 buildFolder 中生成联编文件，并使用指定的工具链或模板联编文件来编译在 RTW.BuildInfo 对象中注册的源代码。如果对象位于层次结构的顶层，该函数将对层次结构中的每个对象执行该过程。

该函数将编译工件（包括目标代码文件）保存在 buildFolder 中。

函数返回包含显示输出的对象。要查看输出，请运行 disp(buildResults)。

codebuild(buildFolder, Name,Value) 使用一个或多个名称-值对组指定附加选项。

codebuild(buildInfo, Name,Value) 使用一个或多个名称-值对组编译在 buildInfo 中指定的代码。

示例

转移并编译生成的代码

有关如何将生成的代码转移到另一个开发环境中并在其中进行编译的示例，请参阅在另一个开发环境中编译代码。

输入参数

全部折叠

`buildFolder` — 编译文件夹
字符向量 | 字符串

编译文件夹的路径，通常包含生成的源代码。该文件夹必须包含 buildInfo.mat 文件。

示例： codebuild(pathToCodeFolder, 'BuildMethod', myToolchain)

`buildInfo` — 编译信息对象
对象

包含编译和链接所生成代码的信息的 RTW.BuildInfo 对象。

示例： codebuild(myBuildInfo, 'BuildMethod','CMake')

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参数名称，Value 是对应的值。名称-值参数必须出现在其他参数后，但参数对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例： codebuild(pathToCodeFolder, 'BuildMethod', myToolchain)

`BuildMethod` — 编译方法
字符向量 | 字符串

使用以下编译方法之一：

工具链 - 指定工具链的名称，例如 'GNU gcc/g++ | gmake (64-bit Linux)'。
模板联编文件 - 指定模板联编文件的路径。
CMake - 指定 'cmake'，这将为 CMake 编译系统生成 CMakeLists.txt 配置文件。参数值不区分大小写。例如，您也可以指定 'Cmake' 或 'CMake'。

示例： codebuild(pathToCodeFolder, 'BuildMethod', 'CMake')

`BuildVariant` — 编译变体
'STANDALONE_EXECUTABLE' | 'MODEL_REFERENCE_CODER' | 'MEX_FILE' | 'SHARED_LIBRARY' | 'STATIC_LIBRARY'

指定编译输出的类型：

'STANDALONE_EXECUTABLE' - 生成独立可执行文件。
'MODEL_REFERENCE_CODER' - 生成静态库。
'MEX_FILE' - 生成 MEX 文件。此值仅用于编译仿真目标，例如，模型引用仿真目标 (ModelReferenceSimTarget) 和加速模式。
'SHARED_LIBRARY' - 生成动态库。
'STATIC_LIBRARY' - 生成静态库。

示例： codebuild(pathToCodeFolder, 'BuildVariant', 'SHARED_LIBRARY')