codebuild

编译和链接生成的代码

全页折叠

语法

buildResults = codebuild(buildFolder)
codebuild(buildFolder, Name,Value)
codebuild(buildInfo, Name,Value)

说明

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

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

该函数返回一个对象，该对象包含显示输出和最终产品（例如，可执行文件或静态库文件）的路径。要查看显示输出，请运行 disp(buildResults)。要以编程方式访问显示输出，请使用 Log 属性的内容。要确定最终产品，请使用 FinalProduct 属性的内容，例如 finalProduct = buildResults.FinalProduct。

示例

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

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

示例

转移并编译生成的代码

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

输入参数

全部折叠

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

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

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

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

名称-值参数

全部折叠

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

如果使用的是 R2021a 之前的版本，请使用逗号分隔每个名称和值，并用引号将 Name 引起来。

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

使用以下编译方法之一：

  • 工具链 - 指定工具链的名称，例如 'GNU gcc/g++ | gmake (64-bit Linux)'。

  • 模板联编文件 - 指定模板联编文件的路径。

  • CMake - 指定 'cmake'，这将为 CMake 编译系统生成 CMakeLists.txt 配置文件。参量值不区分大小写。例如，您也可以指定 'Cmake' 或 'CMake'。

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

指定编译输出的类型：

  • 'STANDALONE_EXECUTABLE' - 生成独立可执行文件。

  • 'MODEL_REFERENCE_CODER' - 生成静态库。

  • 'MEX_FILE' - 生成 MEX 文件。此值仅用于编译仿真目标，例如，模型引用仿真目标 (ModelReferenceSimTarget) 和加速模式。

  • 'SHARED_LIBRARY' - 生成动态库。

  • 'STATIC_LIBRARY' - 生成静态库。

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

输出参量

全部折叠

捕获显示输出和最终产品（例如，可执行文件或静态库文件）的路径。要查看显示输出，请在命令行窗口中运行 disp(buildResults)。要以编程方式访问显示输出，请使用 Log 属性的内容。要确定最终产品，请使用 FinalProduct 属性的内容。例如：

finalProduct = buildResults.FinalProduct

版本历史记录

在 R2020b 中推出

另请参阅

|

主题