Jak: přidat vlastní sestavení krok MSBuild projektů

Vlastní sestavení kroku je uživatelem definovaný krok v nové sestavení.Vlastní sestavení kroku se chová jako jakékoli jiné příkaz nástroje krok jako standardní nástroj krok kompilace nebo propojení.

Určete vlastní sestavení krok v souboru projektu (.vcxproj).Krok můžete určit příkazového řádku spustit žádné další vstupní nebo výstupní soubory a zprávy zobrazit.Pokud MSBuild Určuje výstupní soubory jsou zastaralé s ohledem na vstupní soubory, zobrazí zprávu a provede příkaz.

Chcete-li určit umístění vlastní sestavení kroku v sekvenci sestavení cíle, použít jeden nebo oba CustomBuildAfterTargets a CustomBuildBeforeTargets prvků XML v souboru projektu.Můžete například určit, že spustí vlastní sestavení krok po nástroj cíl odkazu a před cílové manifestu nástroj.Skutečná sada dostupných cílů závisí na vaší zejména sestavení.

Zadat CustomBuildBeforeTargets prvek spustit vlastní sestavení krok před spuštěním určitého cíle, CustomBuildAfterTargets prvek spustit 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, nástroj pro vlastní build spustí výchozí umístění, což je po Link cíl.

Sestavení vlastní kroky a nástroje pro vytváření vlastních sdílet informace zadané v CustomBuildBeforeTargets a CustomBuildAfterTargets prvky XML.Proto zadejte tyto cíle pouze jednou v souboru projektu.

Definovat, co je proveden krok vlastní sestavení

• Přidáte skupinu vlastností do souboru projektu.V této skupině vlastnost zadejte příkaz, jeho vstupů a výstupů a zprávy, jak ukazuje následující příklad.Tento příklad vytvoří soubor CAB ze souboru main.cpp, vytvořené v Názorný postup: Vytvoření projektu 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>
  

Definujte, kde v sestavení vlastní sestavení krok provede

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

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

Viz také

Úkoly

Názorný postup: Vytvoření projektu Visual C++ pomocí nástroje MSBuild

Jak: použití sestavení událostí MSBuild projektů

Jak: přidat vlastní sestavení nástroje MSBuild projektů