Procedure: Aangepaste buildhulpprogramma's toevoegen aan MSBuild-projecten

Een aangepast build-hulpprogramma is een door de gebruiker gedefinieerd opdrachtregelprogramma dat is gekoppeld aan een bepaald bestand.

Geef voor een bepaald bestand op in het projectbestand (.vcxproj) de opdrachtregel die moet worden uitgevoerd, eventuele andere invoer- of uitvoerbestanden en een bericht dat moet worden weergegeven. Als MSBuild bepaalt dat uw uitvoerbestanden verouderd zijn ten opzichte van uw invoerbestanden, wordt het bericht weergegeven en wordt het opdrachtregelprogramma uitgevoerd.

Aangepaste buildhulpprogramma's en aangepaste buildstappen opgeven

Als u wilt opgeven wanneer het aangepaste buildhulpprogramma wordt uitgevoerd, gebruikt u een of beide CustomBuildBeforeTargets elementen en CustomBuildAfterTargets XML-elementen in het projectbestand. U kunt bijvoorbeeld opgeven dat uw aangepaste buildhulpprogramma wordt uitgevoerd na de MIDL-compiler en vóór de C/C++-compiler. Geef het CustomBuildBeforeTargets-element op om de tool uit te voeren voordat een bepaalde target wordt uitgevoerd. Gebruik het CustomBuildAfterTargets element om het hulpprogramma uit te voeren nadat een bepaald doel is uitgevoerd. Gebruik beide elementen om het hulpprogramma uit te voeren tussen de uitvoering van twee doelen. Als geen van beide elementen is opgegeven, wordt het aangepaste buildhulpprogramma uitgevoerd op de standaardlocatie, die vóór het MIDL-doel valt.

Aangepaste buildstappen en aangepaste buildhulpprogramma's delen de informatie die is opgegeven in de CustomBuildBeforeTargets en CustomBuildAfterTargets XML-elementen. Geef deze doelen één keer op in het projectbestand.

Een aangepast build-tool toevoegen

1. Voeg een itemgroep toe aan het projectbestand en voeg een item toe voor elk invoerbestand. Geef de opdracht en de invoer, uitvoer en een bericht op als metagegevens van items, zoals hier wordt weergegeven. In dit voorbeeld wordt ervan uitgegaan dat een bestand 'faq.txt' bestaat in dezelfde map als uw project. De aangepaste buildstap kopieert deze naar de uitvoermap.

   <ItemGroup>
     <CustomBuild Include="faq.txt">
       <Message>Copying readme...</Message>
       <Command>copy %(Identity) $(OutDir)%(Identity)</Command>
       <Outputs>$(OutDir)%(Identity)</Outputs>
     </CustomBuild>
   </ItemGroup>
   

Bepalen waar in de build de aangepaste buildhulpprogramma's worden uitgevoerd

1. Voeg de volgende eigenschapsgroep toe aan het projectbestand. U moet ten minste één van de doelen opgeven. U kunt de andere weglaten als u alleen geïnteresseerd bent in het uitvoeren van uw build-stap voor (of na) een bepaald doel. In dit voorbeeld wordt de aangepaste stap uitgevoerd na het compileren, maar vóór het koppelen.

   <PropertyGroup>
     <CustomBuildAfterTargets>ClCompile</CustomBuildAfterTargets>
     <CustomBuildBeforeTargets>Link</CustomBuildBeforeTargets>
   </PropertyGroup>
   

Zie ook

Walkthrough: MSBuild gebruiken om een C++-project te maken
Hoe te: Build-gebeurtenissen gebruiken in MSBuild-projecten
Procedure: Een aangepaste buildstap toevoegen aan MSBuild-projecten
Algemene macro's voor MSBuild-opdrachten en -eigenschappen
MSBuild bekende onderdeelmetadata