Registro de cadenas de herramientas personalizadas
Una cadena de herramientas hace referencia al conjunto de herramientas de compilación (aplicación de compilación, compilador, enlazador, archivador) que convierten el código fuente en un artefacto binario, como una biblioteca estática o dinámica o un archivo ejecutable. Por ejemplo, en Linux, se puede invocar una cadena de herramientas para archivos C con gmake
y establecer la información de la cadena de herramientas en makefile. En el caso de la generación de código C/C++, la cadena de herramientas se define formalmente en un objeto de MATLAB® que se modifica y carga desde un archivo de definición de la cadena de herramientas (archivo m). Escriba y use su propio archivo de definición de la cadena de herramientas cuando realice personalizaciones intensivas en el proceso de compilación.
La infraestructura de la cadena de herramientas de MATLAB Coder™ se basa en una clase denominada coder.make.ToolchainInfo
. En la instanciación de un objeto, las propiedades del objeto almacenan la información formal de la cadena de herramientas, como las rutas a las herramientas de compilación, las sintaxis de los comandos que llaman a las herramientas de compilación y los indicadores que se añaden a los comandos. Los métodos coder.make.ToolchainInfo
específicos permiten acceder a las propiedades de objeto de la cadena de herramientas y modificarlas. El generador de código usa la definición de objeto que se ha completado para crear y llamar a makefile desde su cadena de herramientas.
En la infraestructura de generación de código, después de crear el objeto de cadena de herramientas a partir de su archivo de definición de cadena de herramientas, lo guarda y, luego, registra el objeto para generar código. Asigne el nombre del objeto a la propiedad Toolchain
de su objeto de configuración de generación de código. Consulte los ejemplos destacados para ver demostraciones completas.
Clases
coder.make.BuildConfiguration | Represent build configuration |
coder.make.BuildItem | Represent build item |
coder.make.BuildTool | Represent build tool |
coder.make.ToolchainInfo | Represent custom toolchain |
Temas
Conceptos básicos del registro de cadenas de herramientas personalizadas
- Custom Toolchain Registration
Register third-party software build tools for creating executables and libraries. - About coder.make.ToolchainInfo
coder.make.ToolchainInfo
represents a custom toolchain. - Toolchain Definition File with Commentary
Create a toolchain definition file.
Flujo de trabajo típico
- Create and Edit Toolchain Definition File
Create and edit a toolchain definition file for a new custom toolchain. - Create and Validate ToolchainInfo Object
Create and validate a ToolchainInfo object from the toolchain definition file. - Register the Custom Toolchain
Register custom toolchain before you use it. - Use the Custom Toolchain
Build an executable or library with the custom toolchain.
Resolución de problemas
- Troubleshooting Custom Toolchain Validation
Troubleshoot validation errors. - Prevent Circular Data Dependencies with One-Pass or Single-Pass Linkers
UseStartLibraryGroup
andEndLibraryGroup
linker directives.