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

  • Článek

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

Zadejte vlastní krok sestavení v souboru projektu (.vcxproj). Tento krok může zadat příkazový řádek, který se má provést, jakékoli 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 zastaralé, pokud jde o vaše vstupní soubory, zobrazí zprávu a spustí příkaz.

Pokud chcete určit umístění vlastního kroku sestavení v posloupnosti cílů sestavení, použijte jeden nebo oba CustomBuildAfterTargets prvky XML CustomBuildBeforeTargets v souboru projektu. 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 sestavení.

Zadejte prvek, který CustomBuildBeforeTargets 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 konkrétním cílovém spuštění, nebo oba prvky, které mají provést krok mezi dvěma sousedními cíli. Pokud není zadaný žádný prvek, váš vlastní nástroj sestavení se spustí ve výchozím umístění, které je za cílem propojení .

Vlastní kroky sestavení a vlastní nástroje sestavení sdílejí informace zadané v elementech CustomBuildBeforeTargets XML.CustomBuildAfterTargets 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 jazyka 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 je můžete vynechat, pokud chcete, aby se vlastní krok spustil před nebo po určité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