Registrazione della catena di strumenti personalizzata
Una catena di strumenti si riferisce all'insieme di strumenti di compilazione (applicazione di compilazione, compilatore, linker, strumento di archiviazione) che convertono il codice sorgente in un artefatto binario, come una libreria statica o dinamica o un file eseguibile. Ad esempio, in Linux®, si invoca una toolchain per i file C con gmake
e si impostano le informazioni sulla toolchain nel makefile. Per la generazione di codice C/C++, la catena di strumenti è formalmente definita in un oggetto MATLAB® che viene modificato e caricato da un file di definizione della catena di strumenti (m-file). Scrivere e utilizzare il file di definizione della catena di strumenti quando si eseguono personalizzazioni intensive del processo di compilazione.
L'infrastruttura della catena di strumenti di MATLAB Coder™ è basata su una classe chiamata coder.make.ToolchainInfo
. Nell'istanziazione di un oggetto, le proprietà dell'oggetto memorizzano le informazioni formali della catena di strumenti, come i percorsi degli strumenti di compilazione, le sintassi dei comandi che chiamano gli strumenti di compilazione e gli indicatori da aggiungere ai comandi. Metodi specifici di coder.make.ToolchainInfo
consentono di accedere e modificare le proprietà dell'oggetto catena di strumenti. Il generatore di codice utilizza la definizione dell'oggetto completata per creare e chiamare il makefile per la catena di strumenti.
Nell'infrastruttura di generazione di codice, dopo aver creato l'oggetto catena di strumenti dal file di definizione della catena di strumenti, salvarlo e quindi registrarlo per la generazione di codice. Assegnare il nome dell'oggetto alla proprietà Toolchain
dell'oggetto di configurazione della generazione di codice. Per una dimostrazione completa, vedere gli esempi in evidenza.
Classi
coder.make.BuildConfiguration | Represent build configuration |
coder.make.BuildItem | Represent build item |
coder.make.BuildTool | Represent build tool |
coder.make.ToolchainInfo | Represent custom toolchain |
Argomenti
Nozioni di base per la registrazione della catena di strumenti personalizzata
- 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.
Workflow tipico
- 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.
Risoluzione dei problemi
- Troubleshooting Custom Toolchain Validation
Troubleshoot validation errors. - Prevent Circular Data Dependencies with One-Pass or Single-Pass Linkers
UseStartLibraryGroup
andEndLibraryGroup
linker directives.