Enregistrement d’une chaîne d’outils personnalisée
Une chaîne d’outils (toolchain) est un ensemble d’outils de compilation (application de compilation, compilateur, éditeur de liens, archiveur) qui convertissent le code source en un artefact binaire tel qu’une bibliothèque statique ou dynamique ou encore un fichier exécutable. Par exemple, sous Linux®, vous invoquez une chaîne d’outils pour des fichiers C avec gmake
et définissez les informations de cette chaîne d’outils dans le fichier makefile. Pour la génération de code C/C++, la chaîne d’outils est formellement définie dans un objet MATLAB® que vous modifiez et chargez à partir d’un fichier de définition de chaîne d’outils (fichier M). Écrivez et utilisez votre propre fichier de définition de chaîne d’outils lorsque vous utilisez un processus de compilation fortement personnalisé.
L’infrastructure de chaîne d’outils de MATLAB Coder™ repose sur une classe nommée coder.make.ToolchainInfo
. Dans une instanciation d’objet, les propriétés de l’objet contiennent les informations formelles sur la chaîne d’outils telles que les chemins d’accès à vos outils de compilation, la syntaxe des commandes qui les appellent et les indicateurs à ajouter à ces commandes. Des méthodes coder.make.ToolchainInfo
spécifiques permettent d’accéder aux propriétés de l’objet de chaîne d’outils. Le générateur de code utilise la définition d’objet complète pour créer et appeler le fichier makefile de votre chaîne d’outils.
Dans l’infrastructure de génération de code, une fois l’objet de chaîne d’outils créé à partir de votre fichier de définition de chaîne d’outils, vous le sauvegardez puis l’enregistrez pour la génération de code. Affectez le nom de l’objet à la propriété Toolchain
de votre objet de configuration de la génération de code. Pour des démonstrations complètes, consultez les exemples proposés.
Classes
coder.make.BuildConfiguration | Represent build configuration |
coder.make.BuildItem | Represent build item |
coder.make.BuildTool | Represent build tool |
coder.make.ToolchainInfo | Represent custom toolchain |
Rubriques
Fondamentaux de l’enregistrement d’une chaîne d’outils personnalisée
- 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 classique
- 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.
Résolution des problèmes
- Troubleshooting Custom Toolchain Validation
Troubleshoot validation errors. - Prevent Circular Data Dependencies with One-Pass or Single-Pass Linkers
UseStartLibraryGroup
andEndLibraryGroup
linker directives.