Postupy: Přidání vlastního kroku sestavení do projektů MSBuild

Vlastní krok sestavení je krok definovaný uživatelem v sestavení. Vlastní krok sestavení se chová jako jakýkoli jiný krok příkazového nástroje , například standardní krok nástroje kompilace nebo propojení.

Zadejte vlastní krok sestavení v souboru projektu (.vcxproj). Krok může určit příkazový řádek, který se má provést, všechny další vstupní nebo výstupní soubory a zprávu, která se má zobrazit. Pokud nástroj MSBuild zjistí, že vaše výstupní soubory jsou vzhledem k vašim vstupním souborům zastaralé, zobrazí zprávu a spustí příkaz.

Pokud chcete určit umístění vlastního kroku sestavení v pořadí cílů sestavení, použijte v souboru projektu jeden nebo oba CustomBuildAfterTargets elementy a CustomBuildBeforeTargets XML. Můžete například určit, že se vlastní krok sestavení spustí za cílem nástroje propojení a před cílem nástroje manifestu. Skutečná sada dostupných cílů závisí na konkrétním buildu.

CustomBuildBeforeTargets Zadejte element, který má provést vlastní krok sestavení před spuštěním konkrétního cíle, CustomBuildAfterTargets element, který má provést krok po spuštění konkrétního cíle, nebo oba prvky pro provedení kroku mezi dvěma sousedními cíli. Pokud není zadaný žádný prvek, vlastní nástroj pro sestavení se spustí ve výchozím umístění, což je za cílem propojení .

Vlastní kroky sestavení a vlastní nástroje sestavení sdílejí informace zadané v elementech CustomBuildBeforeTargets a CustomBuildAfterTargets XML. Proto v souboru projektu zadejte tyto cíle jen jednou.

Definování toho, co se provádí v kroku vlastního sestavení

1. Přidejte do souboru projektu skupinu vlastností. V této skupině vlastností zadejte příkaz, jeho vstupy a výstupy a zprávu, jak je znázorněno v následujícím příkladu. Tento příklad vytvoří soubor .cab ze souboru main.cpp, který jste vytvořili v návodu: Vytvoření projektu C++ pomocí nástroje MSBuild.

   <ItemDefinitionGroup>
     <CustomBuildStep>
       <Command>makecab.exe $(ProjectDir)main.cpp $(TargetName).cab</Command>
       <Outputs>$(TargetName).cab</Outputs>
       <Inputs>$(ProjectDir)main.cpp</Inputs>
     </CustomBuildStep>
   </ItemDefinitionGroup>
   

Definování, kde se v sestavení provede vlastní krok sestavení

1. Do souboru projektu přidejte následující skupinu vlastností. Můžete zadat oba cíle, nebo můžete jeden vynechat, pokud chcete, aby se vlastní krok spustil před nebo po konkrétním cíli. Tento příklad říká nástroji MSBuild , aby provedl vlastní krok po kroku kompilace, ale před krokem propojení.

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

Viz také

Návod: Vytvoření projektu C++ pomocí nástroje MSBuild
Postupy: Použití událostí sestavení v projektech MSBuild
Postupy: Přidání vlastních nástrojů sestavení do projektů MSBuild