Build Configuration

Configuration of build settings such as output file name, location, type, language

To control and configure the build process for generating binary code, there are many parameters and settings. These settings control attributes such as the output build type (MEX, lib, dll, or exe) and C versus C++ language. Other build settings enable you to customize the build output according to specific needs, such as readability, performance, and external code integration. You can modify the build options in the code generation configuration object from the app or from the command line. You can create the configuration object by using coder.config. Open the object in the editing app by using open. To specify additional build files and flags from inside your function code, use coder.updateBuildInfo.

Functions

expand all

Specify Code Generation and Build Configuration Options

`coder.config`	Create MATLAB Coder code generation configuration objects
`coder.updateBuildInfo`	Update build information object `RTW.BuildInfo`

Create and Manage Target Object Data

`target.add`	Add target object to internal database
`target.clear`	Clear all target objects from internal database
`target.create`	Create target object
`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
`target.upgrade`	Upgrade existing definitions of hardware devices

Add Flags, Defines, Files, and Paths to Build Information Objects

`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
`addSourceFiles`	Add source files to build information
`addSourcePaths`	Add source paths to build information
`addTMFTokens`	Add template makefile (TMF) tokens to build information
`removeSourceFiles`	Remove source files from build information object

Find Arguments and Files in Build Information Objects

`findBuildArg`	Find a specific build argument in build information
`findIncludeFiles`	Find and add include (header) files to build information

Get Flags, Defines, Files, and Paths from Build Information Objects

`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
`getSourceFiles`	Get source files from build information
`getSourcePaths`	Get source paths from build information

Set Output Options in Build Information Objects

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

Update File Paths, Extensions, and Separators in Build Information Objects

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

Objects

`coder.MexCodeConfig`	Configuration parameters for MEX function generation from MATLAB code
`coder.CodeConfig`	Configuration parameters for C/C++ code generation from MATLAB code
`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`	Create hardware board configuration object for C/C++ code generation from MATLAB code
`coder.ReplacementTypes`	Configuration parameter to specify custom names for MATLAB built-in data types in C/C++ code generation
`RTW.BuildInfo`	Provide information for compiling and linking generated code

Classes

`coder.ExternalDependency`	Interface to external code
`target.Alias`	Create alternative identifier for target object
`target.CMake`	Specify CMake installation for building generated code
`target.CMakeBuilder`	Configure how CMake builds generated code
`target.CMakeBuildType`	Describe CMake build type or build configuration
`target.CMakeCacheEntry`	Configure a CMake cache entry
`target.EnvironmentConfiguration`	Configure system environment for toolchain
`target.HardwareComponentSupport`	Describe support for a hardware component
`target.LanguageImplementation`	Provide C and C++ compiler implementation details
`target.Object`	Base class for target types
`target.Processor`	Provide target processor information
`target.Toolchain`	Capture high-level information about toolchain

Packages

target Manage target hardware and build tool information

Topics

Build Configuration Basics

Configure Build Settings
Configure build configuration parameters at the command line or in the MATLAB^® Coder™ app.
Build Process Customization
Control aspects of the build process that occur after code generation but before compilation.
Paths and File Infrastructure Setup
Specify location of custom code.
Share Build Configuration Settings
Export project settings to a code generation configuration object or import the settings into a project.
Specify Configuration Parameters in Command-Line Workflow Interactively
Edit code generation configuration objects interactively.
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.
Build Process Support for File and Folder Names
Troubleshoot build process errors that occur when file system issues prevent file processing.

Specific Build Options

Preserve Variable Names in Generated Code
Improve readability of generated C/C++ code by preserving your variable names in the generated code.
How MATLAB Coder Partitions Generated Code
Select file partitioning method.
Change the Language Standard
For calls to math operations, the code generator uses the language standard that you specify in the build settings.
Specify Data Types Used in Generated Code
Generate built-in C types or MathWorks^® predefined types.
Register New Hardware Devices
Extend the range of supported hardware by registering new devices.
Configure CMake Build Process
Specify CMake toolchain definition for building generated code.
Create Custom CMake Toolchain Definition
Capture high-level information about CMake-based toolchain and the target hardware it supports.

Troubleshooting

Compiler and Linker Errors
Address common causes of errors that occur during build.