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

Nástroj pro vlastní sestavení je uživatelem definované, příkazového řádku nástroj, který je přidružen k určitému souboru.

Pro určitý soubor zadejte v souboru projektu (.vcxproj) na příkazovém řádku spustit, žádné další vstupní nebo výstupní soubory a zprávy zobrazované.Pokud MSBuild Určuje výstupní soubory jsou zastaralé s ohledem na vstupní soubory, zobrazí se zpráva a spustí nástroj příkazového řádku.

Chcete-li určit, kdy se spustí nástroj pro vlastní sestavení, použijte jednu nebo obě CustomBuildBeforeTargets a CustomBuildAfterTargets prvky XML v souboru projektu.Například můžete určit, zda spustit nástroj pro vlastní sestavení po MIDL kompilátoru a před kompilátor C/C++.Určete, CustomBuildBeforeTargets prvek, jak tento nástroj spustit před spuštěním určitého cíle; CustomBuildAfterTargets prvek, který chcete spustit nástroj po určitý cíl; nebo oba prvky, spusťte nástroj mezi prováděním dvou cílů.Pokud není zadán žádný prvek, spustí nástroj pro vlastní sestavení na výchozí umístění, které je před MIDL cíl.

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

Chcete-li přidat nástroj pro vlastní sestavení

• Přidat skupinu položek do souboru projektu a přidejte položku pro každou vstupní soubor.Zadejte příkaz, další vstupy, výstupy a zprávu jako metadata položky, jak je znázorněno zde.Tento příklad předpokládá, že soubor "faq.txt" existuje ve stejném adresáři jako váš projekt.

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

Chcete-li definovat, kde v sestavení bude spouštět nástroje pro vlastní sestavení

• Přidejte následující skupiny vlastností do souboru projektu.Je třeba zadat alespoň jeden z cílů, ale ostatní můžete vynechat, pokud vás zajímají pouze v kroku sestavení spustit před (nebo po) s konkrétní cíl.Tento příklad provádí vlastní krok po kompilaci, ale před propojením.

  <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 kroku sestavení do projektů MSBuild