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

Vlastní krok sestavení je uživatelem definovaný krok v sestavení.Vlastní krok sestavení se chová stejně jako jakýkoli jiný příkaz nástroj kroku, jako je standardní nástroj kroku kompilace a propojení.

Určete vlastní krok sestavení v souboru projektu (.vcxproj).Kroku můžete zadat příkazový řádek pro spuštění libovolné další vstupní nebo výstupní soubory a zprávy zobrazované.Pokud MSBuild Určuje výstupní soubory jsou zastaralé, pokud jde o vstupní soubory, zobrazí se zpráva a provede příkaz.

Chcete-li určit umístění vlastní sestavení kroku v sekvenci cíle sestavení, použijte jednu nebo obě z CustomBuildAfterTargets a CustomBuildBeforeTargets prvky XML v souboru projektu.Například může zadat, že vlastní krok sestavení spuštěna po nástroj cíl odkazu a před cílový nástroj manifest.Skutečná sada dostupných cílů závisí na vaší konkrétní sestavení.

Zadejte CustomBuildBeforeTargets prvku k provedení vlastního kroku sestavení před spuštěním ke konkrétnímu cíli, CustomBuildAfterTargets prvek, který chcete provést krok po spuštění určitého cíle nebo obou prvků provést krok mezi dvěma sousedními cíli.Pokud není zadán žádný prvek, spustí nástroj pro vlastní sestavení na výchozí umístění, které je po Link cíl.

Vlastní kroky sestavení a nástroje pro vlastní sestavení sdílet informace uvedené v CustomBuildBeforeTargets a CustomBuildAfterTargets prvky XML.Proto určete tyto cíle pouze jednou v souboru projektu.

Chcete-li definovat, co je provedeno pomocí vlastní krok sestavení

• Přidáte skupinu vlastností do souboru projektu.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 vytvořené v Návod: Vytvoření projektu jazyka Visual C++ pomocí nástroje MSBuild.

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

Chcete-li definovat, kde v sestavení vlastního kroku sestavení provede

• Přidejte následující skupiny vlastností do souboru projektu.Můžete zadat oba cíle nebo jeden můžete vynechat, pokud chcete vlastní krok provést před nebo za konkrétní cíl.Tento příklad říká MSBuild k provedení vlastní krok po kroku kompilace, ale před krok propojení.

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

Viz také

Úkoly

Návod: Vytvoření projektu jazyka Visual C++ pomocí nástroje MSBuild

Postupy: Použití událostí sestavení v projektech MSBuild

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