编译配置

编译设置的配置，例如输出文件的名称、位置、类型、语言

要控制和配置生成二进制代码的编译过程，需要使用许多参数和设置。这些设置用来控制一些属性，如输出的编译类型（MEX、lib、dll 或 exe），以及输出的语言是 C 还是 C++ 等等。其他编译设置允许您根据特定要求自定义编译输出，例如可读性、性能和外部代码集成。您可以从 App 或在命令行中修改代码生成配置对象中的编译选项。使用 coder.config 创建配置对象。使用 open 在编辑 App 中打开对象。要从函数代码内指定其他编译文件和标志，请使用 coder.updateBuildInfo。

函数

全部展开

指定代码生成和编译配置选项

`coder.config`	创建代码生成配置对象
`coder.updateBuildInfo`	更新 `RTW.BuildInfo` 编译信息对象

创建和管理目标对象数据

`target.add`	Add target object to internal database
`target.clear`	Clear all target objects from internal database (自 R2023a 起)
`target.create`	创建目标对象
`target.export`	Export target object data
`target.get`	Retrieve target objects from internal database
`target.remove`	Remove target object from internal database
`target.update`	Update target objects in internal database (自 R2023a 起)
`target.upgrade`	Upgrade existing definitions of hardware devices

为编译信息对象添加标志、定义、文件和路径

`addCompileFlags`	Add compiler options to build information
`addDefines`	Add preprocessor macro definitions to build information
`addIncludeFiles`	Add include files to build information
`addIncludePaths`	Add include paths to build information
`addLinkFlags`	Add link options to build information
`addLinkObjects`	Add link objects to build information
`addNonBuildFiles`	Add nonbuild-related files to build information
`addPreincludeFiles`	Add preinclude files to build information (自 R2024a 起)
`addSourceFiles`	Add source files to build information
`addSourcePaths`	Add source paths to build information
`addUndefines`	Add undefine preprocessor directives to build information (自 R2024a 起)
`removeIncludePaths`	Remove include paths from build information (自 R2023b 起)
`removeSourceFiles`	Remove source files from build information object (自 R2021b 起)
`removeUndefines`	Remove undefine preprocessor macros from build information (自 R2024a 起)

查找编译信息对象中的参量和文件

`findBuildArg`	在编译信息中查找特定编译参量
`findIncludeFiles`	Find and add include (header) files to build information

从编译信息对象中获取标志、定义、文件和路径

`getBuildArgs`	Get build arguments from build information
`getCompileFlags`	Get compiler options from build information
`getDefines`	Get preprocessor macro definitions from build information
`getFullFileList`	Get list of files from build information
`getIncludeFiles`	Get include files from build information
`getIncludePaths`	Get include paths from build information
`getLinkFlags`	Get link options from build information
`getNonBuildFiles`	Get nonbuild-related files from build information
`getPreincludeFiles`	Get preinclude files from build information (自 R2024a 起)
`getSourceFiles`	Get source files from build information
`getSourcePaths`	Get source paths from build information
`getUndefines`	From build information, get preprocessor macros to undefine (自 R2024a 起)

在编译信息对象中设置输出选项

setTargetProvidesMain Disable inclusion of code generator provided (generated or static) main.c source file during build

更新编译信息对象中的文件路径、扩展名和分隔符

`updateFilePathsAndExtensions`	Update files in build information with missing paths and file extensions
`updateFileSeparator`	Update file separator character for file lists in build information

代码配置设置

全部展开

输出

编译类型	要从生成的 C/C++ 代码编译的输出
语言	要在生成代码中使用的语言
语言标准	Language standard to use for the generated code
自定义输出文件	Name of code generation output file
仅生成代码	仅生成源代码
验证模式	代码验证模式
编译文件夹	Folder type for files generated during build process
编译文件夹路径	Folder path for files generated during build process
工作文件夹	Current working folder type for build process
工作文件夹路径	Current working folder path for build process

速度

启用对 CTRL+C 和图刷新的响应	响应性检查
保留外部调用	Extrinsic function call support
检查内存完整性	Memory integrity checking
对整数溢出进行饱和处理	Integer overflow support
仅支持纯整数	Detection of floating-point code
支持非有限数	支持非有限值
循环展开阈值	Threshold on the number of iterations that determines whether to automatically unroll a `for`-loop and a `parfor`-loop
保留入口函数的输入数据	是否保护入口函数输入数据不被修改
尽可能启用 OpenMP 库	Parallelization of `parfor`-loops
启用自动并行化	`for` 循环的自动并行化
最大 CPU 线程数	运行并行 for 循环的最大 CPU 线程数
利用目标硬件指令集扩展	SIMD instruction set for target hardware
FMA	Whether to use SIMD instructions for fused multiply add operations
用户编写的 MATLAB 函数的内联策略	Control inlining between user-written functions
MathWorks 编写的 MATLAB 函数的内联策略	Control inlining between MathWorks functions
MathWorks 函数和用户函数之间调用的内联策略	Control inlining between user-written functions and MathWorks functions
优化归约	Generate SIMD code for reduction operations \| Parallelize for-loops performing reduction operations
硬件 SIMD 加速	Level of SIMD intrinsics

内存

全局数据同步模式	Global data synchronization mode
启用可变大小	可变大小数组支持
启用动态内存分配	启用可变大小数组的动态内存分配
动态内存分配阈值	可变大小数组的动态内存分配的大小阈值
对固定大小数组启用动态内存分配	固定大小数组的动态内存分配
动态内存分配接口	Dynamically allocated array at generated function interface
数组布局	行优先数组布局
保留数组维度	N 维索引
最大堆栈使用量	每个应用程序的最大堆栈使用量
生成可重入代码	多实例、可重入代码
保留未使用的字段和属性	Preserve unused class properties or structure fields in the generated C/C++ code

代码外观

生成文件的分区方法	File partitioning mode
大型常量生成	Whether to write large deep learning constants to binary data files
大型常量阈值	Threshold above which the code generator writes DNN constants to binary data files
包括注释	Comments in generated code
注释样式	Comment style in the generated code
MATLAB 源代码作为注释	Inclusion of MATLAB source code as comments in generated code
MATLAB 源代码注释行号	Include line numbers of MATLAB source code as comments in the generated code
MATLAB 函数帮助文本	函数前注中的 MATLAB 函数帮助文本
需求汇总作为注释	将需求链接作为注释包含在内
将 if-elseif-else 构型转换为 switch-case 语句	`if-elseif-else` 构型到 `switch-case` 语句的转换
在函数声明中保留 extern 关键字	Preservation of the `extern` keyword in function declarations
使用有符号左移位进行定点运算和 2 次幂的乘法	Replacement of multiplications by powers of two with signed left bitwise shifts
允许有符号整数右移	Signed right bitwise shifts in generated code
圆括号	Parenthesization level in the generated code
最大标识符长度	Maximum number of characters in generated identifiers
头文件防卫式声明样式	Style of preprocessor directive in generated code
缩进样式	Style for placement of braces in the generated code
缩进大小	每个缩进级别的字符数
列限制	生成代码中换行符前的最大列数
数据类型替换	生成代码中的数据类型替换
启用自定义数据类型替换	Custom names for data types in generated code
从外部头文件导入自定义类型	Whether to import type definition from external header files
头文件	External header files that contain custom type definitions
全局变量	全局变量标识符的自定义标识符格式
全局类型	全局类型标识符的自定义标识符格式
全局类型的字段名称	Custom identifier format for field names in global type identifiers
局部函数	局部函数标识符的自定义标识符格式
局部临时变量	Custom identifier format for local temporary variable identifiers
常量宏	常量宏标识符的自定义标识符格式
EMX 数组类型	EMX 数组类型的自定义标识符格式
EMX 数组工具函数	EMX 数组工具函数的自定义标识符格式
生成的源文件和头文件名称格式	File name customization macro
代码生成模板文件	Code generation template for file and function banners
选择要使用的代码格式工具	Formatting tool for generated code
控制 clang 格式配置文件的使用	Control generation of `clang-format` file

调试

启用 C/C++ 编译器调试模式	C 编译器调试模式
生成运行时错误检查	Run-time error detection and reporting in generated code
显示详尽的编译器输出	Code generation progress display
始终创建报告	代码生成报告
报告与 MATLAB 的差异	Potential differences reporting
突出显示潜在的数据类型问题	Highlighting of potential data type issues in the code generation report
突出显示潜在的行优先问题	潜在的行优先布局问题
突出显示隐式扩展导致的潜在问题	Highlight potential implicit expansion issues
突出显示使用 coder.loop 函数的潜在问题	Highlight potential loop control issues
生成静态代码度量报告	Static code metrics report
生成代码替换报告	Code replacement report
生成报告后自动启动报告	Automatic open of code generation report
将报告信息导出到变量	包含代码生成报告信息的变量的名称
为 SIL 或 PIL 启用源代码级别调试	Debugging of generated code during a SIL or PIL execution
检查常量输入	Constant input checking mode for a SIL or PIL execution
同步全局数据	Global data synchronization mode for a SIL or PIL execution
启用入口函数执行探查	Execution time profiling during a SIL or PIL execution
启用函数执行探查	Execution time profiling of functions called within entry-point functions during a SIL or PIL execution
指定探查保存选项	Collection and storage of execution-time measurements
启用入口函数堆栈探查	Stack usage profiling during a SIL or PIL execution
启用 C/C++ 代码覆盖率	Analysis of C/C++ code coverage
启用执行探查	Instrumentation for profiling

自定义代码

代码替换库	Code replacement library for generated code
使用内置 FFTW 库	生成使用 MATLAB 附带的 FFTW 库的代码
自定义 FFT 库回调	Callback class for FFTW library calls
自定义 BLAS 库回调	BLAS callback class
自定义 LAPACK 库回调	LAPACK callback class
使用预编译库	Whether to use precompiled libraries in generated code
源文件	出现在生成的 `.c` 或 `.cpp` 文件顶部附近的代码
头文件	出现在生成的 C/C++ 头文件顶部的自定义代码
初始化函数	要包含在生成的初始化函数中的自定义代码
终止函数	Code that appears in the generated terminate function
其他包括目录	Include folders to add to include path for compiling generated code
其他源文件	Source files to compile and link with the generated code
其他库	Static library files to link with the generated code
代码生成后的命令	自定义编译处理的命令
保留名称	Names that code generator must not use for functions or variables

硬件

硬件板	Name of hardware board
生产设备详细信息:设备供应商	Manufacturer of production hardware
生产设备详细信息:设备类型	Type of production hardware
生产设备详细信息: char	Length in bits of the C `char` data type
生产设备详细信息: short	Length in bits of the C `short` data type
生产设备详细信息: int	Length in bits of the C `int` data type
生产设备详细信息: long	Length in bits of the C `long` data type
生产设备详细信息: long long	Length in bits of the C `long long` data type
生产设备详细信息: float	Length in bits of the C floating-point data type
生产设备详细信息: double	C `double` 数据类型的长度（以位为单位）
生产设备详细信息: 计算机字长	Microprocessor native word size
生产设备详细信息: 指针	Length in bits of pointer data
生产设备详细信息: size_t	Length in bits of `size_t` data
生产设备详细信息: ptrdiff_t	Length in bits of `ptrdiff_t` data
生产设备详细信息:字节顺序	Significance of the first byte of a data word
生产设备详细信息:采用算术移位方式右移有符号整数	将有符号整数右移实现为算术右移
生产设备详细信息:启用 long long	long long 数据类型支持
生产设备详细信息:最大原子整数大小	Largest atomic integer size for production hardware
生产设备详细信息:最大原子浮点数大小	Largest atomic floating-point size for production hardware
生产设备详细信息:有符号整数除法舍入方式	Rounding for division of two signed integers
目标设备详细信息:设备供应商	Manufacturer of test hardware
目标设备详细信息:设备类型	Type of test hardware
测试设备详细信息: char	Length in bits of the C `char` data type
测试设备详细信息: short	Length in bits of the C `short` data type
测试设备详细信息: int	Length in bits of the C `int` data type
测试设备详细信息: long	Length in bits of the C `long` data type
测试设备详细信息: long long	Length in bits of the C `long long` data type
测试设备详细信息: float	Length in bits of the C floating-point data type
测试设备详细信息: double	C `double` 数据类型的长度（以位为单位）
测试设备详细信息: 计算机字长	Microprocessor native word size
测试设备详细信息: 指针	Length in bits of pointer data
测试设备详细信息: size_t	Length in bits of `size_t` data
测试设备详细信息: ptrdiff_t	Length in bits of `ptrdiff_t` data
测试设备详细信息:字节顺序	Significance of the first byte of a data word
测试设备详细信息:采用算术移位方式右移有符号整数	将有符号整数右移实现为算术右移
测试设备详细信息:启用 long long	long long 数据类型支持
测试设备详细信息:最大原子整数大小	Largest atomic integer size for test hardware
测试设备详细信息:最大原子浮点大小	Largest atomic floating-point size for test hardware
测试设备详细信息:有符号整数除法舍入方式	Rounding for division of two signed integers
工具链	用于编译 C/C++ 库或可执行程序的工具链
自定义工具链选项	Custom settings for tools in selected toolchain
编译配置	Compiler optimization or debug settings for toolchain
测试硬件与生产硬件相同	Equivalence of production and target hardware characteristics

C++ 语言功能

C++ 命名空间	生成的 C++ 代码的命名空间名称
接口样式	Interface style for generated C++ code
C++ 接口类名称	Interface class name for generated C++ code
从 MATLAB 命名空间生成 C++ 命名空间	Generate C++ namespaces for MATLAB namespaces
MathWorks 代码的命名空间	Place C++ code generated for MathWorks code in a separate namespace
从 MATLAB 类生成 C++ 类	为 MATLAB 类生成 C++ 类
从 MATLAB 枚举生成 C++ 枚举类	Whether to generate C++ enumeration classes for MATLAB enumerations

高级

强制转换模式	数据类型强制转换级别
常量折叠超时	Maximum number of instructions to be executed by the constant folder
编译时递归限制	Maximum number of function specializations for compile-time recursion
自动运行初始化函数	Automatically run the initialize function
需要初始化函数	Initialize function generation
需要终止函数	Terminate function generation
为已知的 MISRA 违规生成申述注释	Add annotations to suppress known MISRA/AUTOSAR violations
生成示例主函数	示例 C/C++ 主文件生成
保留变量名称	Variable names to preserve in the generated code
回显不带终止分号的表达式	Expression echoing
生成联编文件	联编文件生成
自动引入外部调用	Automatic extrinsic function calls
简化数组索引	Strength reduction optimization
使用 memcpy 进行向量赋值	Whether to enable `memcpy` optimization
Memcpy 阈值(字节)	Minimum size for `memcpy` or `memset` optimization
使用 memset 将浮点数和双精度值初始化为 0.0	Assignment of float and double zero with memset
常量输入	Constant input checking mode
对 MEX 的编译类型使用 JIT 编译	Just-in-time (JIT) compilation mode
生成非有限值的支持文件(使用时)	Generate support files for nonfinite data only if nonfinite data is used
按引用向入口函数传递结构体	Pass structures by reference
始终为 switch 生成默认 case	Default case for all switch statements
启用代码可追溯性	代码生成报告中的可追溯性
使用 Embedded Coder 功能	是否使用 Embedded Coder 功能
启用隐式扩展	生成代码中的隐式扩展功能
启用自动并行化报告	Reporting for automatic parallelization of `for` loops
启用运行时递归	运行时递归支持
缓存动态数组数据	动态数组优化
SIL/PIL 详细程度	Display communication I/O information during SIL or PIL execution
SIL/PIL 探查度量	PMU metric

对象

`coder.MexCodeConfig`	Configuration parameters for MEX function generation from MATLAB code
`coder.CodeConfig`	从 MATLAB 代码生成 C/C++ 代码的配置参数
`coder.EmbeddedCodeConfig`	Configuration parameters for C/C++ code generation from MATLAB code with Embedded Coder
`coder.HardwareImplementation`	Hardware-specific configuration parameters for C/C++ code generation from MATLAB code
`coder.hardware`	为从 MATLAB 代码的 C/C++ 代码生成创建硬件板配置对象
`coder.ReplacementTypes`	Configuration parameter to specify custom names for MATLAB built-in data types in C/C++ code generation
`RTW.BuildInfo`	提供用于编译和链接生成的代码的信息

类

`coder.ExternalDependency`	Interface to external code
`target.Alias`	Create alternative identifier for target object
`target.CMake`	Specify CMake installation for building generated code (自 R2022b 起)
`target.CMakeBuilder`	Configure how CMake builds generated code (自 R2022b 起)
`target.CMakeBuildType`	Describe CMake build type or build configuration (自 R2022b 起)
`target.CMakeCacheEntry`	Configure a CMake cache entry (自 R2022b 起)
`target.EnvironmentConfiguration`	Configure system environment for toolchain (自 R2022b 起)
`target.HardwareComponentSupport`	Describe support for a hardware component (自 R2022b 起)
`target.LanguageImplementation`	提供 C 和 C++ 编译器实现详细信息
`target.Object`	用于目标类型的基类
`target.Processor`	Provide target processor information
`target.Toolchain`	Capture high-level information about toolchain (自 R2022b 起)

命名空间

target 管理目标硬件和编译工具信息

主题

编译配置基础知识

配置代码生成和编译设置
在命令行或 MATLAB^® Coder™ 中配置代码生成和编译配置参数。
Build Process Customization
Control aspects of the build process that occur after code generation but before compilation.
路径和文件基础架构设置
指定自定义代码的位置。
Build Process Support for File and Folder Names
Troubleshoot build process errors that occur when file system issues prevent file processing.
Share Build Configuration Settings
Export project settings to a code generation configuration object or import the settings into a project.
Specify Code Configuration Parameters Interactively
Configure the code generation process by using the Code Generation Settings dialog box.
C Compiler Considerations for Signed Integer Overflows
For accurate results from signed integer C operations, the C compiler must preserve wrap-on-overflow behavior.
Requirements for Signed Integer Representation
Compile generated code on a target that uses a two’s complement representation for signed integer values.

特定编译选项

在生成代码中保留变量名称
通过在生成代码中保留变量名称来提高生成的 C/C++ 代码的可读性。
Understand and Control Partitioning of the Generated Code
Understand how file partitioning method and inlining settings interact to control the partitioning of the generated code.
更改用于代码生成的语言标准
代码生成器使用您在编译设置中指定的语言标准。
Register New Hardware Devices
Extend the range of supported hardware by registering new devices.
配置 CMake 编译过程
为编译生成的代码指定 CMake 工具链定义。
Create Custom CMake Toolchain Definition
CMake is a third-party, open-source tool for build process management.
Constant Input Checking in MEX Functions
Control whether a MEX function checks the value of a constant input argument.

故障排除

编译器和链接器错误
解决在编译过程中出现错误的常见原因。

精选示例

使用 CMake 工具链编译从 MATLAB 代码生成的 C++ 源代码

使用 CMake 工具链编译生成的代码。

打开实时脚本